用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt;运行前请先检查来源。
npx skills add https://github.com/ming1zhou88/minemap-skills --skill minemap-business-video-projection命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地?可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
| 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基于 SOC 职业分类