场景几何与直播指针

// 实时投影：用调用时刻的几何
projectVideoToGround(points, { groundHeight }): Promise<{ capturedAt; points: (GeoPoint | null)[] } | null>
projectGeoToVideo(points): Promise<{ capturedAt; points: ({ x, y } | null)[] } | null>

// 快照投影：用截图时刻冻结的几何
projectSnapshotVideoToGround(snapshotId, points, { groundHeight }): Promise<Result | null>
projectSnapshotGeoToVideo(snapshotId, points): Promise<Result | null>

releaseSnapshot(snapshotId: string): Promise<void>

const camera = await ctx.capabilities.get('cockpit:camera')
const geometry = await ctx.capabilities.get('cockpit:scene-geometry')
if (!camera || !geometry) return

const frame = await camera.captureFrame({ scale: 1, mime: 'image/jpeg' })
const snapshotId = frame.geometrySnapshotId
if (!snapshotId) return
try {
  const result = await geometry.projectSnapshotVideoToGround(
    snapshotId,
    [{ x: 0.5, y: 0.5 }],
    { groundHeight: 0 },
  )
  if (result?.points[0]) ctx.logger.info('截图中心地理点', result.points[0])
} finally {
  await geometry.releaseSnapshot(snapshotId)
}

interface CockpitLivePointerLease {
  stream: string
  release(): Promise<void>
  dispose(): Promise<void>
  onRevoked(handler: (reason: 'host-mode' | 'disposed') => void): Promise<Disposable>
}

acquire(stream?: string): Promise<CockpitLivePointerLease>

const pointer = await ctx.capabilities.get('cockpit:live-pointer')
if (!pointer) return
const lease = await pointer.acquire('DronePayload')
const revoked = await lease.onRevoked((reason) => {
  annotation.cancel(reason)
})
try {
  await annotation.drawOnce()
} finally {
  await revoked.dispose()
  await lease.release()
}