更新记录

1.0(2026-07-13) 下载此版本

更新记录文案

1.0.0(2026-07-13)

  • 首次发布 Android/iOS 市场版。
  • Android 集成 LibVLC 3.6.5。
  • iOS 集成 MobileVLCKit 3.7.3。
  • 支持 uni-app Vue2、Vue3。
  • 支持 RTSP TCP/UDP、软硬件解码、静音控制。
  • 支持连接/缓冲超时检测和自动重连。
  • 提供 Vue 组件和 UTS API 两种调用方式。
  • 当前版本暂不包含 HarmonyOS NEXT。

平台兼容性

uni-app(5.08)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
× × × -
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
× × × × × × × × × × × ×

shunlu-rtspplayer 插件市场介绍与发布说明

插件市场详细介绍(可直接粘贴)

原生 RTSP 播放器

本插件用于在 uni-app Android/iOS 应用中播放 RTSP 实时视频流。Android 基于 LibVLC,iOS 基于 MobileVLCKit,适用于 IPC 摄像头、监控设备、行车记录仪、无人机、工业相机、局域网视频设备等场景。

核心能力

  • Android/iOS 原生播放
  • Vue2/Vue3
  • TCP/UDP 传输切换
  • 软件/硬件解码切换
  • 播放、暂停、停止、重试、切换地址
  • 静音控制
  • 连接和缓冲超时检测
  • 自动重连与重连次数限制
  • 原生播放器位置自动同步
  • Vue 组件与 UTS API 两种使用方式

适用场景

  • 家用/工业摄像头实时预览
  • 行车记录仪与车载摄像头
  • 安防监控
  • 无人机或机器人图传
  • 局域网 RTSP 设备
  • 设备调试和远程巡检

当前支持

  • Android 5.0+,armeabi-v7a、arm64-v8a
  • iOS 12.0+,arm64
  • uni-app Vue2、Vue3

当前不支持

  • HarmonyOS NEXT(本市场版暂不包含)
  • H5
  • 微信/支付宝等小程序

重要说明

当前原生实现为单实例,同一页面或同一时刻建议只使用一个播放器。原生视频层可能覆盖普通 Vue 弹窗,显示弹窗或切换页面前应先隐藏播放器。不同 RTSP 设备在编码、TCP/UDP、鉴权和关键帧间隔方面存在差异,正式使用前请在目标设备上真机测试。


HBuilderX 发布操作步骤

  1. uni_modules/shunlu-rtspplayer 放入一个干净的 uni-app 测试项目。
  2. 填写 package.json 中的 QQ、仓库地址和最终价格。
  3. 确认插件 ID 的作者前缀与自己的 DCloud 插件市场作者 ID 一致。
  4. Android 和 iOS 分别完成真机播放、前后台切换、重连和销毁测试。
  5. 删除测试项目中的 unpackagenode_modules.git 等无关目录。
  6. 在 HBuilderX 中右键 uni_modules/shunlu-rtspplayer
  7. 选择“发布到插件市场/提交发布”。
  8. 分类选择“UTS 插件 → API 插件”。
  9. 兼容平台选择 Android、iOS、Vue2、Vue3;鸿蒙/H5/小程序选择不支持。
  10. 粘贴本资料包中的标题、摘要、详细介绍和隐私权限声明。
  11. 上传真实 Android/iOS 运行截图。
  12. 发布后使用一个全新的测试项目从插件市场重新导入,再做一次完整回归。

免费/付费设置

当前 package.json 默认免费。若发布付费版,请在发布界面或 dcloudext.sale 中配置普通授权与源码授权价格,并确认 DCloud 当前 UTS 付费插件的加密、试用和云打包规则。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

android.permission.INTERNET android.permission.ACCESS_NETWORK_STATE android.permission.ACCESS_WIFI_STATE android.permission.CHANGE_WIFI_MULTICAST_STATE android.permission.WAKE_LOCK 用于访问 RTSP 视频流、检测网络连接状态、访问局域网摄像头或视频设备,以及在视频播放期间保持必要的网络和设备运行状态。 本插件不申请摄像头、麦克风、通讯录、定位、短信、电话等敏感权限。 NSLocalNetworkUsageDescription 用于连接同一局域网内的摄像头、行车记录仪、监控设备或其他 RTSP 视频设备。 当开发者使用 HTTP 或局域网非 HTTPS 地址时,应用可能还需要根据项目实际情况配置 App Transport Security(ATS)相关选项。

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

本插件不采集、不存储、不分析用户的个人信息、设备身份信息、账号信息、位置信息、通讯录信息或其他隐私数据。 插件仅根据开发者在业务代码中传入的 RTSP 地址,连接对应的摄像头、监控设备或视频服务器,并在用户设备本地接收和播放视频、音频流。 插件访问的服务器地址由使用本插件的开发者自行配置,例如: rtsp://192.168.1.100/live rtsp://example.com/live/stream 本插件不会将 RTSP 地址、视频内容、音频内容、播放日志或设备信息上传至插件作者的服务器,也不包含插件作者自建的数据收集服务器。 数据用途仅限于: 1. 建立 RTSP 视频流连接; 2. 在本地设备上解码并播放视频或音频; 3. 判断播放、缓冲、断开和重连状态; 4. 根据开发者配置执行自动重连。 若开发者接入第三方公网 RTSP 服务,视频流数据将直接在用户设备与开发者配置的 RTSP 服务器之间传输,相关服务器的数据处理和隐私责任由该服务器提供方及应用开发者承担。

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

本插件不包含任何广告。 插件不接入广告 SDK,不展示开屏广告、插屏广告、横幅广告、激励视频广告、信息流广告或其他商业推广内容。 插件不包含统计、用户画像、广告追踪、设备指纹或第三方营销相关功能。

许可协议

MIT License

Copyright (c) 2026 河南顺鹿信息科技有限公司

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

暂无用户评论。