更新记录

1.0.2（2026-03-14） 下载此版本

支持IOS

1.0.1（2026-03-14） 下载此版本

1.0.1 支持多播放器

1.0.0（2026-03-14） 下载此版本

1.0.0 uniappx webrtc监控视频流播放支持h265

平台兼容性

uni-app x(4.56)

vee-webrtc

vee-webrtc 是一个 uni-app x UTS 组件插件，用于监控场景的 WebRTC 播放与控制，支持 Android / iOS。

版本

• 当前稳定版：1.0.2

功能概览

• WebRTC 拉流播放（主画面 / 子画面）
• 远端声音开关
• 对讲（DataChannel 上行音频）
• 云台控制（PTZ）
• 分辨率切换
• 截图保存到系统相册

快速接入

1. 页面模板

<template>
  <vee-webrtc class="player-view" @initElement="onPlayerElement"></vee-webrtc>
</template>

2. 创建播放器实例

import { WebRtcMonitorPlayer } from '@/uni_modules/vee-webrtc'

let player : WebRtcMonitorPlayer | null = null

const onPlayerElement = (element : UniNativeViewElement) => {
  const sdpUrl = 'https://xxx/index/api/webrtc?...'
  player = new WebRtcMonitorPlayer(element, sdpUrl)
  // 主画面建议：开启音频与数据通道
  player.setPlaybackOptions(true, true)
}

3. 常用控制

// 开始/停止播放
player?.start()
player?.stop()

// 声音
player?.setRemoteAudioEnabled(true)
player?.setRemoteAudioEnabled(false)

// 对讲
player?.startTalk(8000)   // 或 16000
player?.stopTalk()

// 云台 / 分辨率
player?.ptzDirectionControl(0) // 上，按设备协议填写命令
player?.changeResolution(2)    // 按设备协议填写分辨率值

// 截图
const result = player?.captureAndSaveToGallery() ?? ''

多画面推荐策略

• 主画面：setPlaybackOptions(true, true)
• 子画面：setPlaybackOptions(true, false)（保留音频轨，默认静音）
• 子画面建议额外调用一次 setRemoteAudioEnabled(false)，避免多路同时出声

API 说明

WebRtcMonitorPlayer 对外主要方法：

• start()：开始播放
• stop()：停止播放
• destroy()：销毁实例
• setPlaybackOptions(enableAudio, enableDataChannel)：设置音频接收与数据通道开关
• setRemoteAudioEnabled(enabled)：开启/关闭远端声音
• startTalk(sampleRate)：开始对讲，sampleRate 支持 8000/16000
• stopTalk()：停止对讲
• ptzDirectionControl(command)：发送云台控制命令
• changeResolution(value)：发送分辨率切换命令
• captureAndSaveToGallery()：截图并保存到相册

权限与配置

Android

• 需声明麦克风权限：
  • <uses-permission android:name="android.permission.RECORD_AUDIO" />
• 对讲前建议先做运行时权限申请。

iOS

• 需在应用配置中提供麦克风与相册写入权限文案（如 NSMicrophoneUsageDescription、NSPhotoLibraryAddUsageDescription）。
• 截图首次会触发相册授权，授权后会自动保存。

常见问题

• 对讲点击后失败：
  • 先确认 DataChannel 已连接（播放器已进入稳定播放状态后再开启对讲）。
  • 确认麦克风权限已授权。
• 截图保存失败：
  • iOS 自定义基座需包含相关媒体能力。
  • Android 请确认系统相册写入流程可用。

版本更新

• 详见 uni_modules/vee-webrtc/changelog.md

开发文档

UTS 语法 UTS API插件 UTS uni-app兼容模式组件 UTS 标准模式组件 Hello UTS