Skip to content

媒体与空间照片 ​

Flutter 客户端对部分照片提供「空间照片」效果:在普通图片上叠加设备可用的深度信息,查看时可以随视角产生轻微空间感。它是照片预览增强,不会改变原始照片内容。

支持范围 ​

当前实现只在 Flutter Android / iOS 原生 App 上尝试生成和展示空间照片:

  • Flutter H5 使用普通照片;
  • uni-app App、H5、微信小程序、抖音小程序不使用这套空间照片实现;
  • 视频不适用此效果。

什么时候会显示 ​

上传照片后,App 会在前台按队列尝试生成深度副文件。只有照片格式、设备能力和图片地址都满足条件,并且生成成功,预览页才会使用空间效果;否则自动回退到普通图片。

深度生成可能受以下情况影响:

  • 设备没有可用传感器或系统能力;
  • 用户开启「减弱动态效果」或关闭动画;
  • App 进入后台、被系统挂起或生成任务被中断;
  • 原图不符合处理条件,或网络/上传失败。

后台不会保证在固定时间内完成。回到 App 前台后,未完成的任务可能继续重试;即使最终失败,也不会阻止原图查看。

查看时切换 ​

在支持空间照片的 Flutter 原生 App 中,媒体预览会根据可用副文件显示空间效果。页面提供普通照片/空间效果切换时,可以手动关闭效果;关闭动画或设备不支持时只显示普通照片。

数据与安全 ​

空间照片的深度数据是与原图关联的辅助媒体。分享或转发时,接收方是否能看到空间效果取决于接收设备和客户端,不应把空间效果当作分享成功的必要条件。