多目摄像机方案

枪球方案

方案简介

与传统摄像机相比，新型枪球双目摄像机的特点是大广角枪机看全景，小广角球机看细节，枪球联动智能追踪，达到兼顾全景看细节的效果。一台顶两台，安装更便捷。

核心优势

• 无需更新嵌入式SDK，设备端只需将视频流拼接后直接传入SDK，无需进行额外的与单目摄像机不同的对接工作。
• 多路视频流拼接进行传输，可有效避免分开通道传输可能导致的音画不同步、某一路出流失败等疑难问题。
• 在涂鸦开发者平台配置后，App 侧自动进行视频流切分。
• 支持枪球联动功能。

方案说明

创建产品

1. 登录 涂鸦开发者平台，并单击 创建产品。

   

2. 选择 摄像机 > 多目摄像机 > 自定义方案。

3. 填写 产品名称 与 产品型号 后，单击 创建产品。

   如果没有找到您想要的摄像机方案，请联系涂鸦相关人员进行咨询。

设备侧

• 依照自身产品形态，将两路视频流进行合并编码为一路视频流，传入涂鸦 SDK（此过程对芯片性能有一定要求）。SDK 会将该路视频流进行传输，App 收到后，根据平台配置进行视频流的分割。
• 在枪球联动功能中，设备需要根据 App 传回的定位坐标进行角度旋转，定位到用户需要观看的目标位置。

App SDK 版本要求

对接双目摄像机要求 App SDK 版本高于 v5.5，而对接三目摄像机要求 App SDK 版本高于 v5.7。

接入方式

1. 在涂鸦开发者平台 高级功能 里，打开 IPC视频流分割高级能力，并单击 配置。需联系涂鸦项目经理开通白名单后可见。

   

2. 根据摄像机参数，进行配置。

   

• 配置较为复杂，先在以下例子基础上进行修改。如有疑问，请联系项目经理。
• 为了便于观看，以下格式增加了换行。在修改后粘贴时，需去掉换行。

双路视频流分割信息

"total_split_num":2,
"split_info":[
{"index":1,"type":2,"res_pos":[[0,0,640,360],[0,0,1920,1080]]},
{"index":2,"type":1,"res_pos":[[0,360,640,360],[0,1080,1920,1080]]}],
"align_info":
{"align_type":21,"align_group":[[1],[2]],"localizer_group":[2]}}

三路视频流分割信息

正品字：

 "total_split_num":3,
"split_info":[ 
{"index":1,"type":1,"res_pos":[[0,0,640,360],[0,0,1920,1080]]},
{"index":2,"type":2,"res_pos":[[0,360,320,360],[0,1080,960,1080]]}, {"index":3,"type":2,"res_pos":[[320,360,320,360],[960,1080,960,1080]]}],
"align_info":
{"align_type":31,"align_group":[[1],[2,3]],"localizer_group":[2,3]}
}

倒品字：

"total_split_num":3,
"split_info":[ 
{"index":1,"type":2,"res_pos":[[0,0,320,360],[0,0,960,1080]]}, {"index":2,"type":2,"res_pos":[[320,0,320,360],[960,0,960,1080]]},
{"index":3,"type":1,"res_pos":[[0,360,640,360],[0,1080,1920,1080]]}],
"align_info":
{"align_type":32,"align_group":[[1,2],[3]],"localizer_group":[1,2]}
}

其中各参数含义为：

参数	描述
total_split_num	分割路数，暂时只支持两路分割
split_info	视频流分割信息详情
index	镜头序号，从 1 开始顺序递增
type	联动类型 0：无联动功能 1：联动球机 2：联动枪机
res_pos	在标清、高清或者更多不同分辨率下，该摄像机的位置信息，格式为 [x,y,w,h]
align_info	分割视频流后，App 窗口排布信息
align_type	窗口排布类型 20：双目，上下排布 21：双目，左右排布 31：三目，品字，上面单窗口，下面两窗口并列 32：三目，倒品字，上面两窗口并列，下面单窗口
align_group	二维数组，排布窗口为并列一排的放在一个数组中
localizer_group	一维数组，用于标记展示定位框的位置，值为 align_group 二维数组中的一个一维数组

需配置特殊 DP：

功能点名称	标识符	数据传输类型	数据类型	说明
（枪机镜头）十字框定位坐标中心	ipc_multi_locate_coor	可下发可上报（rw）	String	用户在枪机的 App 界面上操作，想要球机转动到的坐标位置。x,y 坐标相对于宽高的百分比以逗号隔开，例如 "83, 21"

设备收到如上 DP 后，计算角度旋转到对应位置。

界面详述

UI	功能简介
	单击横屏后，默认每次横屏进入时，按照 index 顺序排布窗口。index 为 1 表示全屏播放窗口，其他窗口按照顺序，在右侧纵向排列。 单击红框里的按钮，可以使小窗口显示或者消失。 单击小窗口，可以切换大小窗口画面位置。
	当设备处于枪球联动功能时，在枪机画面中拖动准星，App 发送具体 DP ipc_multi_locate_coor 给设备，设备计算角度，旋转到对应位置。
	正品字格式，下方定位框横跨两个窗口。
	倒品字格式，上方定位框横跨两个窗口。

长短焦双目方案

适用于长焦+短焦镜头的双目摄像机，长焦看细节，视场角较小，而短焦看全局，视场角较大。该品类双目摄像机大致外观呈现如下。

由于长短焦双目摄像机在 App 播放窗口层面无需区分两个摄像机的行为，播放面板仍以单目摄像机的方式来展示。仅在变焦过程中，切换播放窗口的镜头视频流即可。

对接方案

创建产品

1. 登录 涂鸦开发者平台，并单击 创建产品。

   

2. 选择 摄像机 > 变焦双目摄像机 > 自定义方案。

3. 填写 产品名称 与 产品型号 后，单击 创建产品。

   如果没有找到您想要的摄像机方案，请联系涂鸦相关人员进行咨询。

高级功能

确保选中高级功能 长短焦摄像机高级能力。

自定义 DP

需增加以下自定义 DP：

功能点名称	标识符	数据传输类型	数据类型	说明
双（多）目摄像机变焦倍数	ipc_multi_zoom	rw	Value	可变焦整体范围。 默认：10~30，step 为 1，scale 为 1，单位 x。 示例：变焦范围 1.0x 到 3.0x，变焦最小间隔为 0.1
双（多）目镜头变焦临界点	ipc_multi_zoom_critical	rw	String	标识多目摄像机每个变焦临界点，如果多目，使用逗号间隔。 示例：双目 "20" 或三目 "17,30"。实际倍数 = ipc_multi_zoom ÷ scale

嵌入式改动

嵌入式根据 ipc_multi_zoom 的值调整焦距。

• 当 ipc_multi_zoom < ipc_multi_zoom_critical 时，传入长焦视频流。
• 当 ipc_multi_zoom > ipc_multi_zoom_critical 时，传入短焦视频流。
• 当 ipc_multi_zoom = ipc_multi_zoom_critical 时，可由嵌入式自行决定传入视频流。

UI 展示