心是桃源，处处水云

1) 手电筒（Torch）#

• 功能：尝试调用摄像头轨道的 torch 能力，实现“开/关手电筒”。
• 使用方式：
  • 点击“初始化/授权”
  • 若设备支持，会显示 torch：支持，此时可点击“开启/关闭”
  • 用完建议点“释放资源”
• 注意：
  • 需要浏览器支持 getUserMedia，并且必须在 HTTPS 或 localhost 环境下。
  • 并非所有设备/浏览器都支持 torch，即使能打开摄像头也可能不支持开灯。

对应实现：src/components/lab/FlashlightLab.svelte。

2) 定位（Geolocation）#

• 功能：获取一次性的当前位置，包括经纬度、精度、海拔、速度、朝向、时间戳等。
• 使用方式：点击“获取定位”，等待结果。
• 注意：
  • 同样要求 HTTPS 或 localhost。
  • 若拒绝权限/设备无定位/超时，会显示对应错误提示。

对应实现：src/components/lab/GeolocationLab.svelte。

3) 拍照（Camera Snapshot）#

• 功能：调用摄像头预览画面，并把当前帧截图为 jpeg，支持直接下载。
• 使用方式：
  • 选择“前置/后置”摄像头
  • 点击“初始化/授权”
  • 点击“拍照”生成图片
  • 点击“下载”保存到本地
• 注意：
  • 需要 HTTPS 或 localhost。
  • 用完建议“释放资源”，避免摄像头占用。

对应实现：src/components/lab/PhotoLab.svelte。

4) IP（IPv4 / IPv6）#

• 功能：并行请求多个公共接口，取第一个符合格式校验的结果，分别显示 IPv4 与 IPv6。
• 使用方式：点击“获取”。
• 注意：
  • 某些网络环境可能没有 IPv6 出口，因此 IPv6 获取失败是正常情况。
  • 这个功能依赖公网接口可用性，若被拦截或超时也会提示失败。

对应实现：src/components/lab/IpLab.svelte，辅助工具：src/utils/lab-utils.ts。

Q1：为什么我在本地打开 http://ip:port 不能用摄像头/定位？#

因为很多浏览器 API 只允许在 安全上下文 使用：

• 可以：https://你的域名/...、http://localhost/...
• 通常不行：http://局域网IP/...

Q2：为什么手电筒显示“不支持”？#

torch 是摄像头轨道的能力，不是所有手机/浏览器都提供。就算有闪光灯，也不一定开放给 Web。

Q3：IPv6 获取失败是不是 bug？#

不一定。常见原因：

• 你的网络没有 IPv6 出口
• 公网接口被 DNS/防火墙拦截
• 接口返回了 IPv4（会被格式校验过滤掉）