القائمة
MineMap 视频投射与视频管理业务规范。用于监控视域、摄像头覆盖模拟、视频贴投到模型/地表/3D Tiles。
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
استنادا إلى تصنيف SOC المهني
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/ming1zhou88/minemap-skills --skill minemap-business-video-projectionيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
عرض SKILL.md
MineMap 3D 公告板（Billboard）专题。覆盖 BillboardMaterial / BillboardGeometry / BillboardInstance 动画、拾取高亮、动态纹理更新与轨迹对象联动；不与 DOM 覆盖物 Marker 混淆。
MineMap 云与大气渲染链。用于启用体积云（多层 CloudLayer）、单片实例化云（map.cloudCollection）、大气散射与太阳 / 天空辐照度，重点说明主分支公开参数与禁用字段。
MineMap 事件订阅模型、图层事件代理、once/off 管理、矢量与三维对象拾取。
| name | minemap-business-video-projection |
| description | MineMap 视频投射与视频管理业务规范。用于监控视域、摄像头覆盖模拟、视频贴投到模型/地表/3D Tiles。 |
const videoProjection = new minemap.VideoProjection({
location: [116.39, 39.9],
altitude: 80,
fov: 45,
aspect: 16 / 9,
near: 0.1,
far: 200,
heading: 0,
pitch: 0,
roll: 0,
used3DModel: true,
used3DTiles: true,
usedRaster: true,
usedPolygon: true,
videoTextureFun: () => videoElement,
debugVideo: true
});
map.videoManager.add(videoProjection);
视频投射在 MineMap 中不是普通贴图替换，而是一套“投影相机 + 视频纹理 + 命中目标类型筛选”的业务能力。
关键对象：
VideoProjectionmap.videoManagerlocation：必须是经纬度数组videoTextureFun：返回视频源对象的函数altitudeheadingpitchrollfovaspectnearfar源码中支持单独启停：
used3DModelused3DTilesusedPolygonusedRaster业务建议：
used3DModelused3DTilesusedRaster对应 demo：demo/html/VideoProjection.html
这个 demo 已经给出最标准的业务链路：
video DOMvideoTextureFun 返回该 videoVideoProjectionmap.videoManager.add(videoProjection)location / altitude / heading / pitch / roll / near / far / fov / aspect / alphaused3DModel / used3DTiles / usedPolygon / usedRaster另外它还说明，接收投影的自定义 Primitive 必须带上：
usedVideoProjection: true否则不会按预期参与投影。
对应 demo：demo/html/VideoProjectionOnWall.html
适合：
这个 demo 的高价值点在于：
map.videoManager.removeAll()usedPolygon: true对应 demo：demo/html/VideoProjectionOnRaster.html
业务含义不是“推荐直接改私有字段”，而是说明：
debugVideo 和调试视锥对排查非常关键VideoProjection 自带 minzoom/maxzoom 门限。
这是业务上非常重要的成本控制手段：
强约束：minzoom 不能大于 maxzoom。
开启 debugVideo 后，引擎会显示调试视锥体对象。
适用场景：
不要在正式大屏长期开启。
投影永远不是“只创建投影对象就完了”，还必须确认接收体已经具备接收资格：
Primitive：需要显式标记 usedVideoProjection: true如果接收体没有准备好，先检查接收体，而不是先怀疑视频流。
map.videoManager.add(videoProjection, 0);
raise(video)lower(video)remove(video)removeById(uniqueId)removeAll()map.videoManager.enabled = false;
适合临时关闭所有监控投射能力。
业务上还应把它当作“实例生命周期管理器”：
removeAll()remove(video) 后再 add(video)VideoProjectiondebugVideo，上线关闭3d-tilesusedRastervideoTextureFun 返回值不稳定，会造成纹理更新异常_location、_altitude 这类私有字段改写只可视作调试手段，正式业务应优先走公开属性 location、altitude、heading、pitch、rolldemo/html/VideoProjection.htmldemo/html/VideoProjectionOnWall.htmldemo/html/VideoProjectionOnRaster.htmlminemap-business-visibility-analysisminemap-business-oblique-bimminemap-performance-and-backend