切换摄像头

相关参考：Scene API / 相机与拍照

Web 插件既支持“首次打开时指定摄像头”，也支持“运行中切换摄像头”。

首次打开时指定

通过属性 cameraPosition：

await kivicubeIframePlugin.openKivicubeScene(iframe, {
  sceneId,
  cameraPosition: 'front',
});

可选值：

• front
• back

默认是 back。

运行时切换

高级 API 提供：

const next = await api.switchCamera('front');
console.log(next); // 'front' 或 'back'

限制

这里需要注意：

• switchCamera() 暂时只在场景 SceneApi 中提供，后续合辑也会添加
• 当场景模式是 web3d 时会直接报错，因为该模式本身不依赖真实摄像头

因此它更适合图像追踪和云识别场景。

推荐使用场景

• 默认后摄打开，但允许用户切到前摄
• 自拍类互动
• 需要和宿主页面自己的“翻转摄像头”按钮联动

注意

• 切换摄像头本身会重新打开媒体流，建议给用户一个短暂加载提示。
• 不同浏览器对切换的支持并不一致，存在不支持的情况。
• 如果用户设备只有一个摄像头，体验上要做好兜底。