更新记录
1.0.0(2026-11-17)
- 新版发布
平台兼容性
uni-app x(5.21)
| Chrome | Safari | Android | iOS | 鸿蒙 | 微信小程序 |
|---|---|---|---|---|---|
| × | × | √ | √ | √ | × |
其他
| 多语言 | 暗黑模式 | 宽屏模式 | 蒸汽模式 |
|---|---|---|---|
| × | × | × | √ |
yt-imou-camera
面向 uni-app x 标准模式组件的乐橙摄像头播放器,使用 <yt-imou-player> 嵌入页面。组件提供视频区域、方法和事件;播放按钮、录像列表等业务界面由接入方实现。
提供实时预览、监听声音、截图、本地 MP4 录像、语音对讲、SD/云录像查询与回放、方向云台控制、另存系统相册及页面生命周期管理接口。接口实现范围与实际验证范围见下方说明。 设备能力、授权、网络和开放平台资源额度仍需满足对应功能要求。
特别提醒
- 购买或正式接入前,请先使用自己的账号、摄像头和目标平台真机充分试用,确认所需功能满足业务要求。
- 本插件仅支持 uni-app x 标准模式组件,提供 Android、iOS、HarmonyOS 实现;普通 uni-app、Web 和小程序不在当前支持范围内。
- Android/iOS 试用必须先制作包含本插件的自定义基座,或重新打包安装。 修改原生源码、权限、依赖或 SDK 后也需要重新制作基座;鸿蒙使用本地 DevEco 工具链编译、签名和安装,步骤见 安装到工程。
-
三端运行/试用及自定义基座体积提醒: 当前插件同时携带 Android、iOS 和鸿蒙 SDK。Android、iOS 试用时制作自定义基座,或提交云打包时,若保留其他两端的 SDK,可能因上传项目体积过大而提示“项目体积已超过免费额度”“App 大小超限”或超限余额不足。 鸿蒙市场加密版首次云编译或重新云编译时,也可能因上传包较大,在
uni_helpers/dist/index.js中报RemoteHostClosedError(远程主机关闭连接)、httpStatusCode: 0,随后停止运行源码授权不需要删除其他两端。运行、试用或制作自定义基座前,可以先在当前打包工程中删除其他两端目录,只保留本次目标平台的原生目录,以减少上传体积、避免超包。 下表中的目录均位于
uni_modules/yt-imou-camera/utssdk/:本次运行或打包平台 保留的目录 可先删除的其他两端目录 Android app-androidapp-ios、app-harmonyiOS app-iosapp-android、app-harmony鸿蒙 HarmonyOS app-harmonyapp-android、app-ios删除前建议将这两个目录另存到工程外,或在单独的打包工程副本中操作;保留目标平台 SDK、公共组件、配置及授权等其他文件。后续切换平台时,须先从完整插件包恢复目标平台目录,再按上表移除本次不使用的两端目录。 本次已验证移除 Android、iOS 目录后可完成鸿蒙构建;实际云打包体积以打包页面测量结果为准,移除其他平台 SDK 不保证所有工程都低于免费额度,也不能保证解决所有网络连接中断问题。相关说明见 8.13 云打包项目体积超免费额度。
- 请结合本文和示例工程的
pages/index/index.uvue集成。插件提供嵌入页面的视频组件及接口,按钮、录像列表等业务界面由接入方实现;完整参数和调用规则见 方法说明。 - 摄像头需要先完成配网并在线,且已添加到开发者应用或取得相应授权。乐橙 App 能预览,不代表开发者应用已经获得设备权限。 当前插件不包含配网、设备绑定或账号登录界面。
deviceId填摄像头标签的 S/N;初始视频解密密码通常为标签上的安全码,修改过则填当前密码。鸿蒙实时预览另需设备详情返回的 V1 playToken。没有后端时,可按 临时测试 token 获取步骤 使用示例工程中的脚本联调;正式项目由后端管理 AppSecret 和 token。- 插件不包含乐橙开放平台的带宽、流量或云存储资源。
FL1003表示平台带宽额度限制,重新获取 token 不会增加额度。开发测试账号目前受此限制,iOS、HarmonyOS 的实际视频和相关媒体功能尚未完成真机验收,具体见 发布说明与验证状态。 - 对讲、方向云台、SD/云录像等功能取决于设备能力、授权和实际录像资源。固定镜头设备无法通过插件增加云台能力;App 本地录制的 MP4 也不会变成摄像头 SD/云录像。
- 当前仅允许一个已连接组件占用 SDK 全局会话。切换到另一个组件前,先对旧组件调用
configure('')或卸载它;仅调用stop()不会释放该会话。页面还需转发onPageShow()/onPageHide(),避免离开页面后继续取流。 - 使用中遇到问题,请先查看 常见问题与解决方法。反馈时提供运行平台、插件版本、设备型号和脱敏后的完整错误信息,不要公开 AppSecret、accessToken、playToken 或视频解密密码。
功能介绍
- 标准组件嵌入: 通过
<yt-imou-player>在.uvue页面中展示视频,使用组件属性传入设备配置,通过组件方法控制操作、事件接收结果,便于接入自己的业务界面。 - 实时预览: 提供实时播放、停止、重新播放及通道、主/辅码流配置;从录像回放切回实时预览时,可调用
play()。 - 声音监听: 通过
setAudio()开启或关闭当前实时/回放流的声音。每次新开流默认静音,声音监听与麦克风对讲分别控制。 - 视频截图: 对已就绪的实时/回放画面生成 JPG,结果事件返回 App 目录内的文件路径,可继续用于展示或另存系统相册。
- 本地录像: 将当前实时/回放视频录制为 App 目录内的 MP4,提供开始、停止及录像结果事件;切后台、切换配置或卸载组件时会结束录制。
- 语音对讲: 提供麦克风授权、建立对讲、停止或取消等待中的对讲,以及建立中/已建立状态通知。实际双向声音效果需要使用支持对讲的设备验证。
- SD/云录像查询: 按北京时间查询指定日期的 SD 卡或云录像,提供分页参数、查询状态和录像条目;每次最多查询 50 条,需要设备和日期确有可用录像。
- 录像回放: 使用查询结果中的录像条目启动 SD/云录像回放,接收播放状态及自然结束事件;当前未开放暂停、时间跳转、倍速和整段录像下载方法。
- 方向云台控制: 对能力信息包含 PT/PTZ 的设备提供上、下、左、右方向指令,每次移动持续 200ms;当前未开放变焦、预置点及连续长按控制。
- 保存系统相册: 将插件生成的 JPG 或已成功结束的 MP4 另存至系统相册,接收保存结果。Android 10+、iOS、HarmonyOS 按各端授权或确认流程处理;Android 7–9 当前仅保留 App 目录内文件。
- 设备能力与运行状态: 提供设备能力信息、初始化/播放/录制/对讲等状态事件及错误回调,用于控制按钮可用状态、展示操作结果和定位问题。
- 生命周期管理: 页面隐藏时停止取流、录制和对讲,返回前台时按预览意愿恢复实时播放,卸载时释放原生资源;录像回放和本地录制不会自动恢复。
以上为当前已封装的功能接口,不代表三端所有功能均已实测通过;各端验证结果见下方说明。完整调用方式、参数和事件见 组件配置、方法说明、录像查询与分页 和 事件及数据字段,SDK 与平台资料见 官方文档。
发布说明与验证状态
开发测试使用的乐橙开放平台账号取流返回 FL1003(开发者当前使用带宽超过额度限制),iOS 和 HarmonyOS 因此尚未完成实际视频画面及相关媒体功能的真机验收。当前版本已提供三端实现并通过编译,但不将 iOS、HarmonyOS 标为全部功能验证通过。
| 平台 | 已完成的验证 | 尚未完成的验证及原因 |
|---|---|---|
| Android | 实时预览、停止/重播、JPG 截图、本地 MP4 录像、保存系统相册及前后台切换已真机验证;声音开关的状态切换已验证 | 双向语音对讲尚未通过,测试曾返回 503009 忙线;实际 SD/云录像回放因没有可用录像未验证;方向云台因测试设备未返回 PT/PTZ 能力未验证。后续取流复测同样受到账号带宽限制 |
| iOS | 官方 SDK 接入、插件编译/链接及初始化、错误回调流程已验证 | 取流测试受到平台带宽限制,实际视频画面、声音、截图、本地录像、相册、双向对讲及录像回放尚未完成真机验收 |
| HarmonyOS | 官方 SDK 接入、UTS/ArkTS 编译及 HAP 构建、签名已验证 | 取流测试受到平台带宽限制,实际视频画面、声音、截图、本地录像、相册、双向对讲及录像回放尚未完成真机验收;云台仍需具有对应能力的设备验证 |
上述带宽限制描述的是开发测试账号当时的资源状态,不表示所有接入用户都会超限。接入方应使用自己的开发者应用、授权设备和有效 token,并确认自己的开放平台账号具有可用带宽/流量。iOS、HarmonyOS 在正式业务使用前,应先用自己的设备和账号验证所需功能。排查步骤见 8.2 带宽限制,资源状态见 乐橙控制台 → 我的资源。
目录
- 特别提醒
- 功能介绍
- 发布说明与验证状态
- 1. 接入条件与安装
- 2. 最小调用示例
- 3. 组件属性与设备配置
- 4. 方法说明
- 5. 录像查询参数与分页
- 6. 事件及数据字段
- 7. 生命周期与文件处理
- 8. 常见问题与解决方法
- 9. 官方文档
1. 接入条件与安装
1.1 平台要求
| 项目 | 要求或说明 |
|---|---|
| 工程类型 | uni-app x,页面使用 .uvue;通过 native-view 承载原生播放器 |
| HBuilderX | 插件声明 ^5.26.0,建议使用兼容的 5.26 或更新版本,并保持编译器与基座版本一致 |
| Android | Android 7.0 / API 24 及以上;随插件提供 OpenSDK 3.13.0,包含 armeabi-v7a、arm64-v8a 原生库 |
| iOS | iOS 13.0 及以上; arm64 Framework,使用真机 |
| HarmonyOS | 随插件提供 OpenSDK 1.0.0 HAR;需要 DevEco、HarmonyOS SDK 和签名。最低系统/工具链须同时满足 uni-app x 与 SDK 要求;当前 DCloud 鸿蒙指南要求设备 API 14+,蒸汽模式的本地原生工具链需按其指南配置 |
| 其他平台 | 本插件未提供 Web、微信小程序等实现,也不包含普通 uni-app .vue/.nvue 接入方案 |
| 并发组件 | 当前实现限制一个已连接组件占用 SDK 全局会话;切换组件前先断开旧组件或卸载它 |
鸿蒙环境以 DCloud 鸿蒙开发指南 和 原生 SDK 鸿蒙版说明 为准。不要仅根据某个原生接口的最低 API 判断整个 uni-app x 工程能否运行。
1.2 开放平台与设备准备
- 设备完成配网且在线,在乐橙 App 中能够正常操作。
- 在 乐橙开放平台 注册开发者应用,并完成设备添加或用户授权。乐橙 App 能观看,不代表你的开发者应用已经获得设备访问权限。
- 准备
accessToken、设备序列号deviceId和实际视频解密密码decryptKey。deviceId 填摄像头标签的 S/N;本示例设备的初始视频解密密码填标签上的安全码,修改过密码则填写修改后的当前值。 - 鸿蒙实时预览还需要设备详情返回的 V1
playToken。playTokenV2、accessToken、视频密码不能相互替代。设备能力查询不会自动把返回的播放码写入配置。 - SD 回放要求设备确有可用存储卡录像;云回放要求相应设备和日期确有可用云录像。
- 确认开放平台账号有可用的带宽/流量、设备接入权限等资源。
AppId/AppSecret 用于服务端获取 token,不是组件配置参数。正式项目由后端提供 token 和必要的设备播放信息;App 不应保存 AppSecret。无后端联调时,可以在自己电脑上的脚本或官方调试工具中获取 token,再临时填入页面。插件本身不提供 AppSecret 换 token 方法,也不自动刷新 token。
当前 iOS/HarmonyOS 的设备信息、SD/云录像列表由插件发起兼容查询请求,使用已有 token,system.appId/sign 为空;这与官方公开 HTTP API 要求的服务端签名流程不同,不能把联调成功视为已满足公开签名接入规范。正式项目应由后端按 官方调用约定 和 签名规则 提供这些数据;不要把 AppSecret 写入 App 来补签名。视频播放、截图、录制和对讲仍通过各端官方媒体 SDK 执行。
获取方式见 accessToken 接口、设备详情字段说明 和对应平台 SDK 下载包中的接口说明。token 有有效期,应按接口返回的有效期管理,不能把示例 token 当成永久凭证。
1.3 安装到工程
把完整的 yt-imou-camera 目录复制到工程 uni_modules 中:
你的 uni-app x 工程/
├─ pages/
└─ uni_modules/
└─ yt-imou-camera/
├─ package.json
├─ README.md
├─ components/yt-imou-player/yt-imou-player.uvue
└─ utssdk/
├─ app-android/
├─ app-ios/
└─ app-harmony/
- 使用 easycom 自动识别
<yt-imou-player>,页面无需导入原生NativeImouPlayer类。 - Android/iOS 需制作包含插件的自定义调试基座,或重新打包安装;普通标准基座不包含新增的原生 SDK。修改原生源文件、权限、依赖或 SDK 后,要重新制作基座。
- 鸿蒙通过 HBuilderX 调用本地 DevEco 工具链编译、签名和安装,不使用 Android/iOS 的调试基座。
- 保留目标平台的 SDK 文件、
config.json、权限清单及鸿蒙资源;它们是运行依赖,不能当成示例文件删除。
权限声明已随插件提供:Android 网络/Wi-Fi 状态及录音权限;iOS 麦克风、添加相册/相册和本地网络用途说明;鸿蒙网络及麦克风权限。对讲和相册保存需要按系统提示完成授权/确认。接入方应根据自己的产品用途调整权限说明文本,并检查最终合并后的应用清单。
相关步骤见 DCloud App 运行与自定义基座 和 标准模式原生组件。
1.4 无后端时用 imou_token.py 获取测试 token
脚本在示例工程的 tools/imou_token.py,不在 uni_modules/yt-imou-camera 内。仅导入插件的用户,需要同时取得示例工程中的这个脚本。开发电脑安装 Python 3 即可,不需部署后端或安装第三方 Python 包。
-
在乐橙开放平台创建应用并添加/授权设备,从应用详情取得 AppId、AppSecret。
-
在包含
manifest.json和tools/的示例工程根目录打开终端,执行:python3 tools/imou_token.py -
按终端提示输入 AppId、AppSecret。AppSecret 输入时不显示字符或星号,直接输入后回车即可。
-
成功后复制输出的完整 accessToken,填入示例页面;deviceId 填机身标签的 S/N,视频解密密码填标签安全码,若修改过密码则用当前密码。点击「应用参数并预览」。
-
鸿蒙还需要 V1 playToken,改用下面命令,将引号内文字替换为真实 S/N:
python3 tools/imou_token.py --device-id "替换为摄像头标签的S/N"输入应用信息后,终端额外输出指定设备的 V1 playToken、tlsEnable 和 resolutions。页面展开「高级参数」填写 V1 playToken;换型号时按 resolutions 核对鸿蒙 imageSize,不能把 V1、V2 播放码与 accessToken、视频密码混用。
Windows 若不识别 python3,可改用 py -3 tools/imou_token.py,带设备参数的命令同样替换前缀。脚本仅在终端输出结果,不保存凭证文件,也不会自动更新手机页面或续期 token。管理员 token 有效期和过期处理见 8.3;获取 token 不会增加平台带宽额度。
完整操作步骤及终端提示说明见示例工程根目录 README 的「没有后端,如何取得临时测试 accessToken」。正式项目由后端管理 AppSecret 和 token。
2. 最小调用示例
下面页面包含连接、停止、截图、事件解析及前后台处理。将占位符替换为自己授权设备的参数;正式项目从后端和业务表单取得这些值。
<template>
<view class="page">
<yt-imou-player ref="player" class="camera"
:options="options" :autoplay="true"
@mounted="onPlayerMounted"
@initialized="onInitialized"
@playing=""
@statechange="onStateChange"
@snapshot="onSnapshot"
@error="onPlayerError" />
<text>{{ message }}</text>
<button :disabled="!bridgeReady" @click="connect">应用参数并预览</button>
<button :disabled="!bridgeReady" @click="stop">停止</button>
<button :disabled="!videoReady" @click="capture">截图</button>
</view>
</template>
<script setup lang="uts">
import { ref } from 'vue'
import type { ComponentPublicInstance } from 'vue'
import { onShow, onHide } from '@dcloudio/uni-app'
const player = ref<ComponentPublicInstance | null>(null)
const options = ref('')
const bridgeReady = ref(false)
const videoReady = ref(false)
const pageVisible = ref(false)
const message = ref('等待播放器挂载')
// 组件事件参数直接是 { dataJson: string },不是 event.detail。
function payload(event: UTSJSONObject): UTSJSONObject {
const json = (event['dataJson'] as string | null) ?? '{}'
return JSON.parseObject(json) ?? {} as UTSJSONObject
}
function onPlayerMounted() {
bridgeReady.value = true
message.value = '可以连接设备'
if (pageVisible.value) player.value?.$callMethod('')
else player.value?.$callMethod('')
}
function onInitialized(_event: UTSJSONObject) {
message.value = 'SDK 已初始化,等待画面'
// autoplay=true 会自动预览,此处无需再调用 play。
}
function (_event: UTSJSONObject) {
message.value = '正在播放'
}
function onStateChange(event: UTSJSONObject) {
const data = payload(event)
videoReady.value = (data['ready'] as boolean | null) ?? false
}
function onPlayerError(event: UTSJSONObject) {
const data = payload(event)
message.value = ((data['operation'] as string | null) ?? '') + ':' +
((data['message'] as string | null) ?? '操作失败')
}
function onSnapshot(event: UTSJSONObject) {
const path = (payload(event)['path'] as string | null) ?? ''
message.value = '截图已保存到 App 目录:' + path
// 需要另存相册时,在取得有效路径后调用:
// player.value?.$callMethod('saveToAlbum', path)
}
function connect() {
if (!bridgeReady.value) return
const config: UTSJSONObject = {
accessToken: '替换为有效 accessToken',
deviceId: '替换为设备序列号',
decryptKey: '替换为实际视频密码',
channelId: 0,
streamType: 1,
talkChannelId: -1,
tlsEnable: false
}
// Android/iOS 不要无条件沿用鸿蒙专用的播放码配置。
// #ifdef APP-HARMONY
config['playToken'] = '替换为设备详情的 V1 playToken'
config['imageSize'] = 0
// #endif
const json = JSON.stringify(config)
if (options.value == json) {
// 同样的 prop 字符串不会触发 watch,主动调用 configure 可重新连接。
player.value?.$callMethod('configure', json)
} else {
options.value = json
// 只更新 prop;不要同时再 configure 一次,避免重复初始化。
}
}
function stop() { player.value?.$callMethod('stop') }
function capture() { player.value?.$callMethod('capture') }
onShow(() => {
pageVisible.value = true
player.value?.$callMethod('')
})
onHide(() => {
pageVisible.value = false
videoReady.value = false
player.value?.$callMethod('')
})
// 卸载时组件自动释放原生对象,无需手动调用 destroy。
</script>
<style>
.page { padding: 16px; }
.camera { width: 100%; height: 240px; }
</style>
如果设置 autoplay=false,在 initialized 到达且页面可见后调用 player.value?.$callMethod('play')。mounted 仅表示桥接创建,不能把它当作画面就绪事件。
3. 组件属性与设备配置
3.1 Props
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
options |
string |
'' |
完整设备配置的 JSON 字符串,使用 JSON.stringify(config) 生成;不是对象 prop。变更后重连,传 '' 断开并清除原生对象中的配置 |
autoplay |
boolean |
false |
初始化完成和返回前台时是否希望自动实时预览。改成 false 不会立即停止当前播放,立即停止应调用 stop() |
给组件设置明确的宽高,尤其避免父容器没有高度。默认高度为 220px,可通过 class/style 覆盖。
3.2 options 的全部字段
| 字段 | 类型 | 必填/默认值 | 含义与取值 |
|---|---|---|---|
accessToken |
string |
必填 | 乐橙开放平台授权 token,必须有效并有目标设备权限;不能填 AppSecret |
deviceId |
string |
必填 | 摄像头机身标签 S/N 后的完整序列号;不是型号、IP 地址或账号 ID |
channelId |
number |
0 |
预览/录像通道号,使用非负整数;多通道设备按实际通道填写 |
streamType |
number |
1 |
0 为主码流/高清,1 为辅码流/标清;具体清晰度、码率取决于设备编码设置 |
decryptKey |
string |
见下文 | 视频解密密码,映射 SDK 的 psk;本示例设备初始使用标签安全码,修改过则填当前密码;不是乐橙账号密码或 token |
playToken |
string |
'';鸿蒙实时预览需填写 |
设备详情中的播放码。鸿蒙 OpenSDK 1.0.0 使用 V1;Android/iOS 按对应 SDK、设备接入方式决定是否传入 |
productId |
string |
'' |
产品标识;设备信息接口返回非空值时插件会补全。需要产品标识的 IoT 设备应传正确值,不能填 AppId |
talkChannelId |
number |
-1 |
对讲通道;-1 使用 SDK 默认通道,其余为非负整数。与 channelId 独立 |
tlsEnable |
boolean |
false |
SDK 音视频取流的 TLS 开关,按设备和 SDK 能力配置;不是 OpenAPI 是否使用 HTTPS 的开关 |
imageSize |
number |
0,仅鸿蒙使用 |
SDK 分辨率枚举,0 使用 SDK 默认值。需要显式指定时,按设备详情 resolutions 的实际枚举选择,并与 streamType 对应。Android/iOS 忽略此项 |
视频密码的默认行为存在平台差异: Android 未填或全为空白时使用设备序列号;iOS 未填或空字符串时使用设备序列号;鸿蒙缺省为空,不做序列号回退。加密设备建议三端都显式填入实际视频密码。设备标签安全码可能是初始密码;若用户改过视频加密密码,应使用修改后的值。
accessToken、playToken、decryptKey 各自负责不同环节的授权/播放/解密,不能互换。填入任意播放码也可能改变原生 SDK 的取流行为,应按平台分别配置。
3.3 更新、重试与断开
配置采用整体替换,不会与旧 JSON 合并。更换 token、设备、通道、密码、码流或分辨率时,重新传入完整对象。有效重配会停止当前播放、对讲和本地录像,然后重新初始化。
// 参数有变化:更新 options prop,自动重新初始化。
options.value = JSON.stringify(newFullConfig)
// 参数完全相同:主动重试连接(例如网络恢复后)。
player.value?.$callMethod('configure', options.value)
// 完全断开并归还全局 SDK 占用;不要只调用 stop 后就启动第二个组件。
options.value = ''
上面是三种独立操作,不要为了同一次更新同时修改 prop 和调用 configure。如果一直通过命令式 configure 管理配置,请自己维护完整配置;直接调用 configure 不会回写 options prop。
4. 方法说明
4.1 通用调用规则
const player = ref<ComponentPublicInstance | null>(null)
player.value?.$callMethod('方法名', 参数)
- 组件
@mounted之后再调用;未挂载时使用可选链可能只是跳过调用。 - 所有下列组件方法均不提供可用于判断操作完成的返回值或 Promise。
$callMethod返回不等于播放/对讲/保存已完成,不要用await代替事件监听。 - 统一监听
@error;播放成功看@playing或statechange.ready,对讲看statechange.talking,文件看对应事件。 - 下文“已初始化”指收到
initialized;“画面就绪”指当前流的playing或statechange.ready=true;媒体操作应在页面前台进行。
4.2 configure(optionsJson: string)
参数: optionsJson 是第 3 节完整配置的 JSON 字符串;传精确的空字符串 '' 表示断开并清除内存配置。
效果: 停止当前音视频操作、使旧查询/权限回调失效后重新初始化。即使传入与之前相同的字符串,也会主动重配。成功发出 initializing、initialized;autoplay=true 时随后开始实时预览。失败发出 error。空配置断开不发 initialized。
player.value?.$callMethod('configure', JSON.stringify(fullConfig))
player.value?.$callMethod('configure', '') // 完全断开
4.3 play()
参数: 无。前提: 已初始化,页面可见。
切换到实时预览;如果原来在回放、录制或对讲,会先停止这些操作。每次新开流默认静音。成功发出 opening、playing,其中 mode='live';失败发出 error。手动调用后会记录恢复实时预览的意愿,即使 autoplay=false,返回前台也可能恢复;需要取消恢复时调用 stop()。
player.value?.$callMethod('play')
4.4 stop()
参数: 无。
停止实时/回放窗口、对讲和本地录像,取消自动恢复,发出 stopped 和状态变化。结束录像时也会发出录像结果。保留设备配置和 SDK 会话占用,稍后可以 play();要切换到另一个组件,先 configure('') 或卸载旧组件。
player.value?.$callMethod('stop')
4.5 setAudio(enabled: boolean)
参数: enabled=true 开启当前实时/回放流的声音监听,false 静音。前提: 当前画面就绪,未处于对讲建立中或对讲中。
成功后 statechange.audio 更新。设备/码流无音频或 SDK 切换失败会报 error。这不是麦克风开关,也不会启动对讲;换流后要根据需要重新开启声音。
player.value?.$callMethod('setAudio', true)
player.value?.$callMethod('setAudio', false)
4.6 capture()
参数: 无。前提: 当前实时/回放画面就绪。
生成 App 目录内的 JPG。成功发出 snapshot,从 dataJson.path 取得路径;失败发出 error。不会自动保存到系统相册,也不返回图片 base64。
player.value?.$callMethod('capture')
// 在 snapshot 回调取得 path 后,才能使用这个路径或调用 saveToAlbum。
4.7 startRecord()
参数: 无。前提: 当前实时/回放画面就绪,且未在本地录制。
把当前视频写为 App 目录内的 MP4。开始后发出 recordchange,recording=true,附带 path;此时文件仍在写入。停止、切后台、换配置或卸载会结束录制。
这是 App 本地录像,不是开启摄像头 SD 卡录像或购买/开启云录像,也不会让 queryRecords 查到这份 MP4。
player.value?.$callMethod('startRecord')
4.8 stopRecord()
参数: 无。没有正在录制的文件时直接返回。
结束本地 MP4 并发出 recordchange:recording=false、success、path。仅在 success=true 后把文件作为成功录像使用;失败文件可能被保留以便检查,同时通过 error 提示。写入中的路径不能直接另存相册。
player.value?.$callMethod('stopRecord')
4.9 startTalk()
参数: 无。前提: 实时画面已就绪、页面在前台,设备具有对讲能力且授权允许。
按系统要求申请麦克风,再建立 SDK 对讲。状态中的 talkPending 表示 SDK 对讲建立中的状态,talking=true 表示 SDK 已确认建立。Android 的系统麦克风权限弹窗阶段不一定已设置 talkPending,页面仍应避免连续点击。
建立对讲时暂时关闭当前监听声音。失败通过 error 报告;调用返回不能证明设备已经能听到声音,接入方仍应做真实收听验证。
player.value?.$callMethod('startTalk')
4.10 stopTalk()
参数: 无。
停止当前对讲,或取消等待中的对讲请求,使迟到的授权/SDK 回调失效。状态回到 talking=false、talkPending=false;如果对讲前开着监听,且实时画面仍可用、页面仍在前台,尝试恢复监听声音。
player.value?.$callMethod('stopTalk')
4.11 queryRecords(optionsJson: string)
参数: 录像查询参数 JSON,见第 5 节。前提: 已初始化且页面在前台;不要求当前已经在预览。
按北京时间查询指定日期的 SD 或云录像,每次最多 50 条。进度通过 recordquery,结果通过 records,失败通过 error。新查询会使旧查询结果失效;不要一边连续刷新日期一边把所有回调追加到同一列表。
player.value?.$callMethod('queryRecords', JSON.stringify({
day: '2026-11-17', source: 'sd', offset: 1
}))
4.12 playRecord(recordJson: string)
参数: records.items 中一条录像对象原样 JSON.stringify 后的字符串,字段见第 5.2 节。前提: 已初始化且页面在前台。
切换到对应的 SD/云录像回放,停止当前实时预览、本地录像和对讲。成功的 opening/playing 中 mode='playback';自然播完发出 ended。回放不自动恢复实时预览,切后台后也不自动继续原录像。
// item 必须来自当前设备的 records.items,不要自己拼 recordId。
player.value?.$callMethod('playRecord', JSON.stringify(item))
// 返回实时预览:
player.value?.$callMethod('play')
当前接口从所选条目的 SDK 播放入口启动,不提供暂停、跳转时间、倍速或下载整段录像的公开方法。SD 与云端由各平台 SDK 解析不同标识,不能拿 recordId 当作 HTTP 视频地址。
4.13 ptz(direction: string)
参数: 仅支持 up、down、left、right,分别为上、下、左、右。前提: 实时画面就绪,且设备能力查询返回 PT 或 PTZ。
每次提交一次持续 200ms 的方向移动,成功提交发出 ptz,其中 submitted=true。这仅表示请求已提交,不保证设备机械运动已经完成。当前不提供连续长按、变焦、预置点等方法;固定镜头设备不能通过软件增加云台能力。
player.value?.$callMethod('ptz', 'left')
4.14 saveToAlbum(path: string)
参数: snapshot.path 或已成功结束录像的 recordchange.path,为插件生成的本地 JPG/MP4 路径。不要传 file://、网络地址、base64、其他目录文件或正在录制的文件。
效果: 将文件另存系统相册,成功通过 albumsaved 返回原 path 和平台 uri;失败或用户取消通过 error 返回。允许在没有当前视频流时导出仍然存在的本地媒体,但应由前台页面发起。
| 平台 | 相册行为 |
|---|---|
| Android 10+ | MediaStore 写入 Pictures/Imou 或 Movies/Imou,无需广泛存储读取权限 |
| Android 7–9 | 当前实现不支持另存相册;仍可在 App 专属目录获取截图/MP4 |
| iOS 14+ | 申请仅添加相册权限;uri 为 Photos 资产标识 |
| iOS 13 | 使用相册授权后添加资产 |
| HarmonyOS | 弹出系统资产创建对话框,由用户确认后复制;取消视为本次保存未完成 |
player.value?.$callMethod('saveToAlbum', savedPath)
另存相册不删除原文件;重复导出同一路径可能生成重复相册条目。uri 不能跨平台当成普通文件路径使用。
4.15 () / ()
参数: 均无。必须与所在页面的 onShow / onHide 对应转发,见最小示例。
onPageHide()停止取流、对讲和本地录像,使旧查询/权限回调失效。onPageShow()在已经初始化且仍有实时预览意愿时恢复实时预览;不会自动恢复回放或本地录像。- 插件同时监听宿主 App/原生视图生命周期,但无法据此判断所有 uni 页面的切换状态;业务页面转发仍然必要。
- 组件卸载时自动销毁原生资源。内部的
destroy、setAutoplay不属于页面的公开 ref 方法;分别通过卸载组件、修改autoplayprop 使用对应能力。
onShow(() => { player.value?.$callMethod('') })
onHide(() => { player.value?.$callMethod('') })
4.16 getImouComponentVersion(): string
模块导出的版本查询函数,无参数,返回当前插件版本字符串 0.3.0。它不属于组件方法,不能通过 $callMethod 调用。
// #ifdef APP-ANDROID || APP-IOS || APP-HARMONY
import { getImouComponentVersion } from '@/uni_modules/yt-imou-camera'
console.log(getImouComponentVersion())
// #endif
5. 录像查询参数与分页
5.1 queryRecords 的全部参数
| 字段 | 类型 | 必填/默认值 | 说明 |
|---|---|---|---|
day |
string |
必填 | 北京时间日期,格式 yyyy-MM-dd,例如 2026-11-17;内部查询当天 00:00:00 至 23:59:59 |
source |
string |
'sd' |
'sd' 查询设备存储卡录像,'cloud' 查询云录像;不支持其他值 |
offset |
number |
1 |
SD 分页起始记录序号,1 基计数;有效正整数,最大 2147483598。下一页使用事件给出的 nextOffset,不是自己把页码加一。云查询中不参与游标定位 |
nextRecordId |
string |
'' |
云录像记录游标;首页为空,下一页原样使用 records.nextRecordId |
nextRecordRegionId |
string |
'' |
云录像区域游标;与 nextRecordId 成对传递;SD 查询不使用 |
每页数量固定为 50,不提供 pageSize/count 配置。日期按北京时间处理,不随手机时区变化;非法日期会被拒绝。
5.2 records.items / playRecord 的全部字段
| 字段 | 类型 | 含义与要求 |
|---|---|---|
source |
string |
'sd' 或 'cloud',用于选择原生回放方式 |
recordId |
string |
平台返回的录像 ID/设备文件标识,不能为空;不是本地 MP4 路径 |
recordRegionId |
string |
云录像区域标识,云回放必须非空;SD 通常为空 |
beginTime |
string |
录像开始时间,yyyy-MM-dd HH:mm:ss,北京时间;SD 回放必须有效 |
endTime |
string |
录像结束时间,同样使用北京时间;SD 回放必须晚于开始时间 |
请保留查询结果的全部字段。即使某个平台 SDK 回放只使用其中部分字段,也不要自行省略或改写。
5.3 首页与下一页
// SD 首页
player.value?.$callMethod('queryRecords', JSON.stringify({
day: selectedDay, source: 'sd', offset: 1
}))
// SD 下一页:nextOffset 取自上一页 records 事件,例如 51、101……
player.value?.$callMethod('queryRecords', JSON.stringify({
day: selectedDay, source: 'sd', offset: nextOffset
}))
// 云录像首页
player.value?.$callMethod('queryRecords', JSON.stringify({
day: selectedDay, source: 'cloud', nextRecordId: '', nextRecordRegionId: ''
}))
// 云录像下一页:两个值都取自上一页 records,不使用 offset 代替游标。
player.value?.$callMethod('queryRecords', JSON.stringify({
day: selectedDay, source: 'cloud',
nextRecordId: nextId, nextRecordRegionId: nextRegion
}))
上述 selectedDay、nextOffset、nextId、nextRegion 是页面维护的状态,不是插件全局变量。处理 records 时可按下例读取:
function onRecords(event: UTSJSONObject) {
const data = JSON.parseObject((event['dataJson'] as string | null) ?? '{}')
if (data == null) return
const items = data['items'] as UTSJSONObject[]
const hasMore = (data['hasMore'] as boolean | null) ?? false
const nextOffset = (data['nextOffset'] as number | null) ?? 1
const nextId = (data['nextRecordId'] as string | null) ?? ''
const nextRegion = (data['nextRecordRegionId'] as string | null) ?? ''
// 首页替换列表,后续页追加;切设备/日期/来源时清空旧列表及游标。
// 保存 hasMore 和分页状态,再由“加载更多”按钮触发下一次查询。
// 用户选择单条记录后:
if (items.length > 0) {
// 此处仅演示取值,不建议每次查询后自动播放第一条。
const recordJson = JSON.stringify(items[0])
// player.value?.$callMethod('playRecord', recordJson)
}
}
hasMore 是按当前页数量和游标推进情况推测的;刚好返回 50 条时下一页仍可能为空。插件不自动遍历所有分页。录制卡未安装、未启用录像计划、选错日期、云录像过期或无授权,都可能没有可播放记录;空结果不等于插件异常。
6. 事件及数据字段
6.1 解析方式
mounted 没有业务参数。其余事件统一直接传入以下对象:
{ dataJson: 'JSON 字符串' }
页面读取 event['dataJson'] 后解析,不要访问 event.detail.getString(...)。原生 native-view 的内部事件与页面收到的组件事件不是同一层数据结构。
<yt-imou-player @error="onError" @statechange="onState" />
function onError(event: UTSJSONObject) {
const data = JSON.parseObject((event['dataJson'] as string | null) ?? '{}')
if (data == null) return
const operation = (data['operation'] as string | null) ?? ''
const message = (data['message'] as string | null) ?? '未知错误'
// 显示给用户;不要把完整配置、token 或密码一起写入公开日志。
console.log(operation + ':' + message)
}
function onState(event: UTSJSONObject) {
const data = JSON.parseObject((event['dataJson'] as string | null) ?? '{}')
if (data == null) return
const ready = (data['ready'] as boolean | null) ?? false
// 用 ready 控制截图/本地录像按钮;对讲还应确认 mode='live'。
}
6.2 全部事件
下表字段均指解析 dataJson 后的对象。
| 事件 | 数据字段 | 含义 |
|---|---|---|
mounted |
无参数 | 原生桥接已创建,可以下发配置;尚不表示 SDK 初始化完成 |
initializing |
{} |
正在初始化 SDK |
initialized |
{} |
本次配置的 SDK 初始化流程完成;设备取流/解密仍可能失败 |
opening |
mode: string |
正在开启视频,live 为实时、playback 为回放 |
playing |
mode: string |
SDK 确认当前流开始播放,可结合状态启用媒体操作 |
stopped |
{} |
显式 stop() 后通知;后台等内部清理不要只依赖该事件,应同时处理状态变化 |
ended |
{} |
录像回放自然结束 |
statechange |
见第 6.3 节 | 当前播放器状态的完整快照 |
error |
operation: string、message: string,可选 domain: string、code: number、sdkCode: string、sdkType: number、sdkMessage: string |
操作名与错误说明;iOS 系统网络错误额外带 domain='NSURLErrorDomain' 和数值 code。iOS 播放失败额外带 SDK 原始业务码、来源类型、说明;字符串会脱敏,SDK 未返回时为空串。sdkType 的 0/1/99 分别为 RTSP/HLS/OPENAPI,99 不能当作 FL1003。其他端 SDK/平台码查看 message,不把可选数值 code 当成三端统一业务码。operation 在三端可能有 audio/setAudio、initialize/configure 等差异 |
error 的 iOS 鉴权检查字段 |
可选 diagnosticOperation: string、diagnosticPending: boolean、diagnosticSucceeded: boolean、diagnosticCode: string、diagnosticMessage: string、diagnosticDomain: string |
SDK 返回空业务码、空说明且 sdkType=99 时,额外执行一次 deviceInfo 只读检查。先发送 diagnosticPending=true,检查结束后再次发送 error,带 diagnosticPending=false。成功仅表示该查询成功,不能当作播放成功;失败时记录检查自身的业务码或网络错误。网络错误额外有 domain;这些字段与 SDK 原始字段分开,不覆盖 sdkCode。页面可在 pending 时显示检查中,结束后再提示最终原因 |
error 的 iOS 平台查询字段 |
可选 apiOperation: string、platformCode: string |
设备信息或录像查询收到明确的平台业务错误时,分别表示实际接口名和平台业务码;网络错误仍查看 domain/code |
capabilities |
ptz: boolean、talk: boolean、model: string、abilities: string[] |
设备与通道能力查询结果;model 是设备型号,abilities 是原始能力标识集合 |
snapshot |
path: string、success?: boolean |
成功截图的 App 本地路径。Android 当前不带 success 字段,不能要求它必须为 true 才接受截图 |
recordchange |
recording: boolean、path: string、结束时 success: boolean |
本地录像开始/结束;开始时没有最终 success 结果 |
recordquery |
loading: boolean |
录像查询进行/结束;参数校验失败可能直接 error,后台取消也可能丢弃旧结果,页面需自行复位加载提示 |
records |
见第 6.4 节 | 当前查询页的录像和翻页状态 |
ptz |
direction: string、submitted: boolean |
本次方向指令已提交,非物理动作完成通知 |
albumsaved |
path: string、uri: string |
原文件路径与平台相册标识;Android/HarmonyOS 为相应媒体 URI,iOS 为 Photos 资产标识 |
能力查询是异步操作,capabilities 不保证先于 playing 到达;查询失败不等于设备硬件一定没有该功能。ptz=true / talk=true 表示平台返回了相应能力标识,还需要设备在线、授权和实际操作条件满足。
6.3 statechange 全部字段
| 字段 | 类型 | 含义 |
|---|---|---|
mode |
string |
idle 空闲、live 实时、playback 回放;mode 切换不代表画面已就绪 |
ready |
boolean |
当前流是否已被 SDK 确认为可播放;截图/本地录像以此为前提 |
audio |
boolean |
当前监听声音是否开启;换流默认关闭,对讲时可能临时关闭 |
recording |
boolean |
是否正在写入 App 本地 MP4,不代表设备 SD/云录像状态 |
talking |
boolean |
SDK 对讲是否已建立 |
talkPending |
boolean |
是否处于插件记录的对讲建立等待阶段;不保证涵盖三端所有系统权限弹窗阶段 |
一次操作可能产生多个状态快照,这是资源清理、权限和 SDK 回调分阶段到达的结果。不要用事件次数判断成功次数。
6.4 records 全部字段
| 字段 | 类型 | 含义 |
|---|---|---|
source |
string |
当前查询来源 sd/cloud |
day |
string |
当前查询日期,北京时间 |
items |
录像对象数组 | 当前页结果;每条字段见第 5.2 节 |
hasMore |
boolean |
是否推测还有后续页 |
nextOffset |
number |
SD 下一页起始记录序号;云查询不使用它定位下一页 |
nextRecordId |
string |
云下一页记录游标,可能为空 |
nextRecordRegionId |
string |
云下一页区域游标,须与记录游标一起保存和传递 |
典型实时链路为:mounted → initializing → initialized → opening → playing。期间还可能穿插 statechange、capabilities 或 error,不要把它当成跨平台严格的事件排序协议。
7. 生命周期与文件处理
- 页面隐藏、App 进入后台或原生视图不可用时,插件停止当前媒体操作,避免后台持续取流、录音或录像。
- 返回前台只在仍有实时预览意愿时恢复实时流。回放需重新
playRecord,本地录像需重新startRecord;不要假设自动续录。 - 组件卸载自动清理窗口、系统监听和内存凭证;
stop()保留配置,configure('')才是清空配置的显式断开方式。 - 一个 SDK 全局会话一次只允许一个连接组件占用。多画面列表应只连接当前需要播放的组件;仅停止旧画面不足以归还占用。
- 截图/MP4 在 Android App 专属
imou目录、iOSDocuments/imou、鸿蒙filesDir/imou保存。以事件返回的路径为准,不拼接绝对目录,不假设三端路径一致。 - 插件不自动上传媒体,也不提供删除文件方法。业务需要长期保存、分享、清理空间时,应基于实际平台的文件能力处理;卸载 App 后原私有文件可能被删除,另存相册的副本由系统管理。
- 原生对象不主动持久化 token/密码,但页面预填、日志、业务存储及编译产物仍可能包含这些值。正式发布前移除联调凭证,并由后端管理 AppSecret、token 有效期及设备授权。
8. 常见问题与解决方法
8.1 能初始化但黑屏、一直连接中
initialized 只表示 SDK 初始化流程完成。按顺序检查:
- 用乐橙 App 确认设备在线;检查 App 是否允许联网,特别是 iOS 系统中的无线数据/本地网络授权。
- 确认组件有非零宽高、页面在前台,且已转发
onPageShow。 - 核对 accessToken 的应用授权、有效期、设备 SN、预览通道与真实视频密码。
- 鸿蒙核对 V1 playToken;先按
streamType=1测试辅码流。显式设置 imageSize 时,必须匹配当前设备返回的分辨率枚举。 - 看
error.message及原生 SDK 日志中的具体错误码,按下面鉴权/带宽问题处理。Android/iOS 的接口行为不能直接证明鸿蒙的 SDK 参数已满足。
鸿蒙当前设置了 30 秒连接超时兜底,因为 SDK 1.0.0 的部分失败可能只输出原生日志。收到超时提示只能说明未在期限内确认播放,不能只凭提示文字断定是密码、token 或带宽中的哪一项。
iOS 提示“网络连接已中断”时: 先看 operation、domain 和 code。NSURLErrorDomain/-1005 表示请求传输过程中连接被切断,不能直接推断为带宽超额、token 过期或本地网络权限被拒绝,含义见 Apple 官方说明。设备信息 capabilities 或列表 queryRecords 的失败与播放器 play 的失败分别处理。
iOS 的 deviceInfo、queryLocalRecords、getCloudRecords 只读查询遇到 -1005 时自动再试一次;第二次仍失败才上报错误。切后台、重配、断开或卸载会取消请求及旧代重试。超时、取消、平台鉴权/带宽业务错误不自动重试,视频取流也不会自动重试。此处理不能修复持续断网或增加平台带宽。
仍失败时,保留完整错误行并检查当前 App 的联网授权、同设备换网络后的结果及接口可用性;网页可打开不等于每个 OpenAPI 请求都正常。修改 iOS 原生源码后,需要重新制作/安装包含更新插件的自定义基座或正式包,只刷新页面不会替换 Swift 二进制。
8.2 FL1003 带宽超过额度,是 token 过期吗
当前版本的已知测试限制: 开发测试账号因 FL1003 无法继续取流,iOS、HarmonyOS 的媒体功能尚未完成真机验收,详见文首发布说明与验证状态。同账号的官方 iOS 原生示例也返回该错误。接入用户应检查自己账号的资源状态,不能把开发测试账号超额理解为所有用户均无法使用。
iOS 旧版本只显示 play:/99: 旧逻辑把 错误码 / type:说明 直接拼接,SDK 未返回业务码和说明时只剩来源类型。99 表示 OPENAPI,不代表某个具体失败原因。插件保留 sdkCode/sdkType/sdkMessage,并对空业务码、空说明的 type=99 额外执行 deviceInfo 鉴权检查:若检查返回 TK1002/TK1003,提示更新 token;其他检查结果单独说明,不补造原始 SDK 错误码。单次检查超时 10 秒,只有传输中断 -1005 可再试一次;不重试视频取流。检查成功也不能当作视频已播放,检查本身断网也不能推断 token 失效。Swift 改动需重新制作/安装自定义基座或正式包后生效。类型和回调以 官方 iOS API 索引 指向的 SDK 包内 LCOpenSDK_PlayListenerProtocol.h 为准。
不是同一类错误。官方将 FL1003 定义为开发者带宽使用超限;TK1002 才是 token 过期或不存在,TK1003 表示 token 不合法。具体以 官方错误码 为准。
处理步骤:停止其他测试客户端或页面取流,仅保留一条;使用辅码流,并在设备支持时降低实际编码码率;到 控制台 → 我的资源 检查带宽、流量与套餐状态。1 Mbps 是速率上限,不能理解成会耗尽的 1 MB 文件流量。 辅码流也不保证始终低于账号限额。
单路低码率仍报错时,记录设备型号、时间、错误码及资源页状态提交乐橙工单核查。是否付费和采用哪种计费方式应由账号持有人按资源页规则决定;重装 App、换 token、改 TLS 或插件代码不会增加账号资源额度。
8.3 token 无效或设备没有权限
TK1002:重新获取有效 accessToken,将完整配置中的 token 替换后重新连接。TK1003:检查 token 与应用是否匹配,避免混用不同开发者应用的凭证。- 设备未添加、无权限:在开放平台核对设备绑定/用户授权和通道权限。乐橙 App 中同账号能预览不代表开放平台应用拥有相同授权。
- 只重复调用
play()不会刷新 token;需要更新配置。插件不会自动获取或续期 token。
管理员 token 的有效期按 官方 token 说明 为 3 天。无后端联调时,可在本机运行示例工程中的 python3 tools/imou_token.py,本地输入应用信息后取得新 token,再粘贴到示例页面并点击“应用参数并预览”。AppSecret 不应写进插件或正式客户端;不要把完整凭证贴进问题反馈。
8.4 视频密码在哪里,和 playToken 有什么区别
本示例设备的初始视频解密密码就是摄像头标签上的「安全码」;deviceId 则填同一标签上的 S/N。两者不是同一个值,也不要把设备型号当序列号。若已经修改视频加密密码,应以设备当前实际密码为准;其他型号按设备标签和乐橙 App 安全/视频加密设置核对。不要把账户登录密码、AppSecret、accessToken 或 V1/V2 播放码当视频密码。
三端都建议显式传 decryptKey。鸿蒙同时需要正确的 V1 playToken;视频密码负责解密,播放码负责设备播放环节,两项都正确才可能正常观看。不要为了绕过问题随意关闭视频加密。
8.5 event.detail.getString is not a function
页面接收的是组件事件 {dataJson},直接读取 event['dataJson'];插件内部接收 native-view 事件时也使用属性访问,兼容普通对象。按照第 6.1 节解析,避免依赖 getString() 这类实例方法。替换插件后若仍定位到旧代码,重新编译,并确认运行的是包含更新源码的自定义基座/安装包。
8.6 报“另一个摄像头组件正在连接”
旧组件仍持有全局会话。先对旧组件 configure(''),或通过 v-if 卸载并等待卸载后再连接新组件。stop() 只停止媒体,不归还 SDK 会话占用。检查重复页面、缓存页面及列表中是否同时给多个组件传了有效 options。
8.7 App 在前台,切页面后仍取流或返回后没画面
在实际包含播放器的页面转发 onHide → ()、onShow → (),不要只在应用级生命周期转发。stop() 后取消了恢复意愿,要显式 play();回放停止后要重新选择记录并 playRecord()。同样的 options 字符串不会触发 prop 更新,重试使用 configure(options)。
8.8 有画面没声音、对讲没有声音或 503009 忙线
- 实时/回放默认静音,等
ready=true后setAudio(true);检查设备是否有拾音器、当前码流是否含音频,以及系统媒体音量/输出设备。 - 对讲需要实时预览和麦克风权限。若拒绝后系统不再弹窗,到应用设置允许麦克风后重试。
- 对讲期间监听声音临时关闭属于音频资源管理;判断建立结果看
statechange.talking,不能只看按钮是否点过。 503009对讲忙线时,先结束乐橙 App、其他测试端或其他页面的对讲,调用stopTalk()后再试。确认设备本身支持相应对讲方式。
8.9 截图/录像路径有了,相册却没有;MP4 播不了
截图和 MP4 默认先写 App 目录。需要相册副本时单独 saveToAlbum(path),并等待 albumsaved;确认 iOS 授权、鸿蒙系统保存对话框已完成,Android 版本为 10+。
MP4 必须结束录制且收到 recording=false、success=true 后使用。不要复制或保存仍在录制的文件;检查磁盘空间和录像期间是否断流。success=false 时文件可能保留,但不保证可播放。文件路径不可自行改成网络 URL 或带 file:// 的字符串。
8.10 SD/云录像查不到、下一页重复或回放失败
确认设备确实插卡并启用录像,或有对应云录像服务及尚未过期的记录。日期为北京时间,startRecord() 录到 App 内的 MP4 不在 SD/云查询列表中。
SD 从 offset=1 开始,下一页用 nextOffset;云录像首页双游标为空,之后同时传 nextRecordId 和 nextRecordRegionId。切日期/设备/来源后重置列表与游标。把当前设备查询条目完整传给 playRecord,不要自己填 ID 或丢掉区域、时间字段;查看 error 区分无录像、授权与取流失败。
8.11 云台按钮没效果
先等 capabilities 并确认 ptz=true、实时流 ready;仅 PTZPreset 等相似名字不表示具有方向移动能力。方向只支持 up/down/left/right,单次 200ms。submitted=true 表示已下发,不表示电机已经运动;核对摄像头是否为固定镜头及设备授权。固定镜头不能通过接入插件变成云台机。
8.12 编译后找不到原生类、SDK,或更新原生代码没生效
检查插件目录是否完整,Android AAR、iOS Framework、鸿蒙 HAR 和 config.json 是否保留,是否误用了普通标准基座或旧基座。Android/iOS 修改原生文件后重新制作自定义基座并安装,单纯热更新页面不会替换旧原生库。
iOS 使用 arm64 真机;不要按支持模拟器的 Framework 配置去打包。鸿蒙核对 DevEco/SDK/签名及 uni-app x 的工具链要求;不要删除 HarmonyCameraView.ets。不同插件也引入同一 SDK 时,排查重复类/符号和版本冲突。
8.13 云打包项目体积超免费额度
云打包计费的项目上传体积与最终 APK/IPA 大小是两个概念。三端 SDK 都较大,删除几份示例和测试不一定能把体积降到免费额度内。
先清理构建产物和无用业务资源;只发行一个平台时,可在单独的打包副本里移除不发行平台的原生 SDK 目录,保留主工程的完整三端源码。不要删除目标平台库、随意裁剪 ABI 或压坏 SDK。以 DCloud 云打包体积计费说明 和打包页面测量结果为准。
9. 官方文档
下面链接用于获取平台接入要求、设备字段和错误码。插件页面调用以本 README 的接口为准;官方 SDK 的底层接口不是组件 ref 方法。
| 资料 | 官方地址 |
|---|---|
| 乐橙开放平台 | open.imou.com |
| accessToken 获取接口 | accessToken |
| 请求与签名规范 | 开发规范 |
| 设备详情、播放码及分辨率字段 | listDeviceDetailsByIds |
| 平台错误码 | 错误码 |
| SDK 与资料下载 | 资源下载;具体版本接口说明和示例通常随 SDK 包提供 |
| Android SDK | 安装与初始化、功能集成 |
| iOS SDK | 安装与初始化、功能集成 |
| 鸿蒙 SDK | 安装与初始化、功能集成 |
| 开放平台资源额度 | 我的资源,需登录 |
| uni-app x 标准模式组件 | 标准模式原生组件 |
| UTS 鸿蒙开发 | UTS for Harmony |
| uni-app x 鸿蒙环境 | 鸿蒙开发指南、原生 SDK 鸿蒙版 |
| App 调试与基座 | 运行与调试 |
| 云打包体积计费 | App 大小超限 |

收藏人数:
购买源码授权版(
试用
使用 HBuilder 导入示例项目
赞赏(0)
下载 695
赞赏 16
下载 12772396
赞赏 1959
赞赏
京公网安备:11010802035340号