Android webrtc投屏 开发文档
Android webrtc 接口文档
文档版本: v3 | 更新日期: 2026-01-26
目标用户: Android 开发者、集成商、自动化测试人员
文档类型: 开发者参考手册
说明
⚠️ 前提要求：仅魔云腾 V3 系统支持。V2 及更早版本不可用。
桥接模式
IP 地址：桥接设备的 IP 地址
webrtc 端口（TCP）：固定为 10008
webrtc 端口（UDP）：固定为 10008
非桥接模式
IP 地址（如 192.168.30.2）：用来定位具体的设备或宿主机
webRTC 端口（TCP）：根据设备实例索引计算得出，计算公式为：30000 + (index - 1) × 100 + 7
webRTC 端口（UDP）：根据设备实例索引计算得出，计算公式为：30000 + (index - 1) × 100 + 8
📌 非桥接模式端口列表
Q1 设备端口列表（index 1-12）：
| 实例位 | webRTC 端口（TCP） | webRTC 端口（UDP） |
|---|---|---|
| Q1-1 | 30007 | 30008 |
| Q1-2 | 30107 | 30108 |
| Q1-3 | 30207 | 30208 |
| Q1-4 | 30307 | 30308 |
| Q1-5 | 30407 | 30408 |
| Q1-6 | 30507 | 30508 |
| Q1-7 | 30607 | 30608 |
| Q1-8 | 30707 | 30708 |
| Q1-9 | 30807 | 30808 |
| Q1-10 | 30907 | 30908 |
| Q1-11 | 31007 | 31008 |
| Q1-12 | 31107 | 31108 |
P1 设备端口列表（index 1-24）：
| 实例位 | webRTC 端口（TCP） | webRTC 端口（UDP） |
|---|---|---|
| P1-1 | 30007 | 30008 |
| P1-2 | 30107 | 30108 |
| P1-3 | 30207 | 30208 |
| P1-4 | 30307 | 30308 |
| P1-5 | 30407 | 30408 |
| P1-6 | 30507 | 30508 |
| P1-7 | 30607 | 30608 |
| P1-8 | 30707 | 30708 |
| P1-9 | 30807 | 30808 |
| P1-10 | 30907 | 30908 |
| P1-11 | 31007 | 31008 |
| P1-12 | 31107 | 31108 |
| P1-13 | 31207 | 31208 |
| P1-14 | 31307 | 31308 |
| P1-15 | 31407 | 31408 |
| P1-16 | 31507 | 31508 |
| P1-17 | 31607 | 31608 |
| P1-18 | 31707 | 31708 |
| P1-19 | 31807 | 31808 |
| P1-20 | 31907 | 31908 |
| P1-21 | 32007 | 32008 |
| P1-22 | 32107 | 32108 |
| P1-23 | 32207 | 32208 |
| P1-24 | 32307 | 32308 |
调用 webrtc 播放器
该功能依赖内置的 WebRTC 引擎，需确保设备已加载相关 JS 资源，下载地址：webplayer.zip。
webplayer 目录结构：
/webplayer/
├── public/
│ └── images/
│ └──108.png
│ └──loading.png
│ └──myt_mini.png
├── js/
│ └── adapter-latest.js
│ └── h5.lgair.wt.all.min-2.1.js
│ └── h5.lgair.wt.all.min-2.2.js
│ └── jquery-3.2.1.min.js
└── player.html
- player.html：投屏主页面，加载视频流并渲染
- jquery-3.2.1.min.js：DOM 操作与事件处理库
- adapter-latest.js：WebRTC 浏览器兼容适配器
- h5.lgair.wt.all.min-2.1.js / h5.lgair.wt.all.min-2.2.js：魔云腾自研 WebRTC SDK，封装信令、媒体协商、重连等逻辑
功能说明：调用 webrtc 的播放器
请求方式：GET
调用方法:
-
下载播放器,将压缩包解压到本地目录，下载地址：webplayer.zip
-
打开浏览器，拼接完整 URL
-
确保文件本地目录地址正确
-
检查参数是否正确
-
成功后即可观看 WebRTC 视频流
请求 URL：
webplayer/play.html?shost={ip}&sport={webrtc_port}&q=1&v=h264&rtc_i={ip}&rtc_p={webrtc_port}
请求参数：
| 参数名 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
| shost | 是 | string | WebRTC 流媒体服务器主机地址（如 192.168.99.108） |
| sport | 是 | string | WebRTC 流媒体服务器端口（TCP）（如 31207） |
| q | 是 | string | 视频质量参数 (0=低 1=高) |
| v | 是 | string | 视频编码格式（如 h264） |
| rtc_j | 是 | string | RTC 服务端 IP（与 shost 一致，用于建立点对点连接，如192.168.99.108） |
| rtc_p | 是 | string | WebRTC 端口（UDP）（如 31208） |
请求示例：
GET
"./webplayer/play.html?shost=192.168.99.108&sport=31207&q=1&v=h264&rtc_i=192.168.99.108&rtc_p=31208"
返回示例：
成功：
成功响应（页面加载完成）
失败：
失败响应（页面加载失败）