READ · PROCESS · EXPORT

读取全景视频,
并导出成可播放的视频文件

这是一个可直接上手的操作案例:选择本地视频或生成示例片段,读取元数据,选择导出模式,然后下载结果。页面下方同时给出对应 Insta360 SDK 的真实工程路径。

浏览器演示只演示“读取 → 处理 → 导出”的交互链路,不调用 Insta360 Media SDK 的机外拼接算法。

STEP 01 / 02 / 03

操作台

按顺序操作即可。所有处理都在本机浏览器完成,视频不会上传到服务器。

1

读取视频

选择本地 .insv / .mp4 / .webm 文件,或生成一个示例全景片段。

文件名
未选择
时长
--
分辨率
--
大小
--
2

处理与导出

选择导出模式。浏览器版提供三种可视化处理,不等价于 Insta360 的拼接算法。

等待操作0%
3

操作日志

  1. 等待操作…

HOW IT WORKS

这条链路是怎么走通的

无论浏览器演示还是真实 SDK 集成,核心步骤都是“拿到源素材 → 读取帧 → 处理 → 写出文件”。

01

读取源

读取本地视频文件,取得时长、分辨率、编码容器等基础信息。

02

解帧预览

把视频帧绘制到画布,便于做裁剪、网格叠加或格式转换。

03

编码导出

通过 MediaRecorder 把画布流编码为 WebM,并触发下载。

04

真实工程替换

在正式项目里,用 Camera SDK 取文件、用 Media SDK 做拼接与导出。

BROWSER DEMO vs INSTAsdk

与真实 SDK 的对应关系

下面函数名是流程示意,具体 API 名称与参数请以你申请到的 SDK 文档为准。

环节本页浏览器演示Insta360 真实工程
连接/取素材本地 File 选择或生成示例Camera SDK:连接相机、获取文件列表、下载 .insv
读取元数据video.duration / videoWidth / videoHeightCamera SDK / Media SDK 读取素材信息
画面处理Canvas 裁剪、网格叠加Media SDK:拼接、色彩校准、降噪、防抖
导出MediaRecorder → WebM → 下载Media SDK:导出拼接后的全景视频文件
播放器浏览器原生 video + canvas移动端 SDK 内置全景播放器;桌面端需自备
// 示意调用链(非真实函数名)
connectCamera()          // Camera SDK:连接
getFileList()            // Camera SDK:列出相机内素材
download(".insv")        // Camera SDK:拉取到处理端
openMedia(".insv")       // Media SDK:读取
stitch()                 // Media SDK:机外拼接
stabilize()              // Media SDK:防抖
exportVideo("output.mp4")// Media SDK:导出

NOTES

几个容易踩的点

.insv 可以直接改成 .mp4 吗?

可以,但得到的是双鱼眼、未拼接的视频流。需要拼接后的全景视频,应使用 Media SDK 做机外拼接。

视频支持机内拼接吗?

官方说明中视频不支持机内拼接;照片在部分机型上支持机内拼接。

OSC 能做这个需求吗?

OSC 主要用于相机控制,没有 Media SDK 能力,无法完成视频拼接处理。

桌面端 SDK 自带全景播放器吗?

桌面端只提供全景视频流,不含播放器;iOS/Android SDK 提供内置全景播放器。