BJCast SDK(必捷无线投屏)— HarmonyOS NEXT 发送端
无线投屏 HarmonyOS NEXT 发送端 SDK · V1.0.9 · 苏州必捷网络有限公司
页面说明:本页面满足华为《SDK 合规使用指南规范性参考》要求,集成方在引入本 SDK 时可在此查阅完整披露信息。SDK 不申请、不使用 ohos.permission.READ_DEVICE_IDENTIFIER 等设备唯一性识别相关权限。
BJCast SDK(必捷无线投屏)— HarmonyOS NEXT 发送端
本页面用于:必捷互联官网 SDK 集成栏目 → HarmonyOS NEXT 子栏目
SDK 概览
| 项目 | 信息 |
|---|---|
| SDK 名称 | BJCast SDK(必捷无线投屏) |
| SDK 简介 | 一款专为 HarmonyOS NEXT 系统设计的无线投屏发送端 SDK,提供完整的音视频流编码发送能力,支持开发者快速集成无线投屏功能到自己的应用中。 |
| 开发者(主体) | 苏州必捷网络有限公司 |
| SDK 版本 | V1.0.9 |
| 更新日期 | 2026-05-14 |
| 包类型 | HAR(Harmony 静态共享包) |
| OHPM 包名 | @bjnetworks/hm_bjcast |
| HAR 模块名 | hm_bjcast |
| HAR 文件名 | hm_bjcast-signed.har |
| HAR 文件大小 | 2,479,219 字节(≈ 2.42 MB) |
| 工程文件摘要值(SHA256) | 06101654FDB7B5FF6EFB9D9F95B770AEA8A01615D2EBD7A5AEA9D5416DE6A359 |
| OHPM 中心仓 | https://ohpm.openharmony.cn/#/cn/detail/@bjnetworks%2Fhm_bjcast |
| 适配系统 | HarmonyOS NEXT(API Version 12 及以上) |
| 开发工具 | DevEco Studio 5.0.0 及以上 |
| 开源协议 | Apache-2.0 |
主要功能
BJCast SDK(必捷无线投屏)是一款专为 HarmonyOS NEXT 系统设计的无线投屏发送端 SDK,提供以下核心功能:
- ✅ 音视频流编码发送:高效编码设备屏幕内容和音频,通过网络实时传输
- ✅ 接收端自动发现:自动探测局域网内的投屏接收端设备
- ✅ 投屏会话管理:完整的会话建立、维护和结束流程
- ✅ 投屏控制:支持全屏控制、音频控制、投屏质量调节
- ✅ PIN 码认证:支持投屏密码验证,保障投屏安全
- ✅ 多分辨率适配:支持 1080P、2K、4K 等多种分辨率
- ✅ 低延迟传输:优化的传输协议,实现低延迟投屏体验
个人信息处理规则
重要说明:本 SDK 为发送端 SDK,仅负责将本机屏幕内容投屏到接收端设备。本 SDK 不收集、不读取、不存储任何设备唯一性识别码(如 OAID、AAID、MAC、UDID、IMEI、IMSI 等)。
| 项目 | 信息 |
|---|---|
| 收集的个人信息类型 | 设备信息(设备型号、操作系统版本);网络信息(IP 地址、局域网设备列表);屏幕内容(屏幕图像帧);音频数据(音频流数据,可选) |
| 不收集的设备识别码 | OAID、AAID、MAC、UDID、IMEI、IMSI 等均不收集 |
| 业务参数 sender_id | 由集成方主动传入的业务标识符,不是 SDK 自动收集的个人信息;建议使用随机 UUID 或哈希后的用户 ID |
| 使用目的 | 用于适配不同设备的投屏参数;用于发现和连接投屏接收端;投屏核心功能数据传输;投屏音频同步传输 |
| 存储期限 | SDK 不持久化存储任何个人信息,所有数据仅在投屏会话期间临时使用,会话结束后立即清除 |
| 存储地域 | 所有个人信息均在中国境内存储和处理,不涉及数据跨境传输 |
| 第三方共享 | 不与任何第三方共享(除用于崩溃分析的腾讯 Bugly SDK 外) |
| 用户控制 | 可通过 BJCast.AudioControl(0) 关闭音频采集;通过 BJCast.StopBJCastSession() 结束会话并清除数据 |
| 完整隐私政策 | BJCast SDK 隐私政策 |
合规使用说明
| 项目 | 信息 |
|---|---|
| 延迟初始化要求 | 必须在用户明确同意隐私政策后再调用 BJCast.Init() 初始化 SDK |
| 权限申请时机 | INTERNET 应用启动时申请;KEEP_BACKGROUND_RUNNING 投屏会话建立时申请;custom_screen_recording(敏感权限,需单独授权)开始投屏时申请;microphone(可选)开启音频投屏时申请 |
| 最小化原则 | 仅收集实现投屏功能所必需的最少信息 |
| 完整合规使用说明 | BJCast SDK 合规使用说明 |
下载与集成
方式一:通过 OHPM 中心仓安装(推荐)
ohpm install @bjnetworks/hm_bjcast
或是在项目 oh-package.json5 中添加依赖:
{
"dependencies": {
"@bjnetworks/hm_bjcast": "^1.0.9"
}
}
然后执行:
ohpm install
方式二:本地 HAR 包安装
- 下载 HAR 文件:hm_bjcast-signed.har(开发者自查SHA256:
06101654FDB7B5FF6EFB9D9F95B770AEA8A01615D2EBD7A5AEA9D5416DE6A359) - 将 HAR 包放入项目的
libs目录 - 在
oh-package.json5中添加:
{
"dependencies": {
"hm_bjcast": "./libs/hm_bjcast-signed.har"
}
}
快速开始
1. 导入 SDK
import { BJCast } from 'hm_bjcast';
2. 初始化 SDK(用户同意隐私政策后)
let initParams = {
channel_id: 0, // SDK channel_id,由必捷网络提供
channel_code: "", // SDK channel_code,由必捷网络提供
sender_id: "sender_" + Date.now(), // 发射端ID,需保证唯一性
user_name: "user123456", // 用户自定义名称
encoder_scene_conf: "", // 投屏质量场景配置(可选)
encoder_ext_conf: "" // 额外配置参数(可选)
};
let result = BJCast.Init(initParams);
if (result === 0) {
console.log("SDK 初始化成功");
} else {
console.error("SDK 初始化失败,错误码:" + result);
}
3. 探测接收端并开始投屏
详细 API 文档请参考:BJCast 发射端 SDK 接口文档
系统权限
集成方需在 module.json5 中声明以下权限:
| 权限名称 | 是否可选 | 申请时机 |
|---|---|---|
| ohos.permission.INTERNET | 必选 | 应用启动时 |
| ohos.permission.KEEP_BACKGROUND_RUNNING | 必选 | 投屏会话建立时 |
| ohos.permission.custom_screen_recording | 必选(敏感) | 开始投屏时,需单独授权 |
| ohos.permission.microphone | 可选 | 开启音频投屏时 |
| ohos.permission.get_bundle_info | 必选 | SDK 初始化时 |
操作演示视频
https://v.douyin.com/Hbq9KLFlNIc/
相关下载与文档
| 资源 | 链接 |
|---|---|
| HAR 包(带签名) | hm_bjcast-signed.har(SHA256: 06101654FDB7B5FF6EFB9D9F95B770AEA8A01615D2EBD7A5AEA9D5416DE6A359) |
| OHPM 中心仓详情页 | https://ohpm.openharmony.cn/#/cn/detail/@bjnetworks%2Fhm_bjcast |
| API 接口文档 | BJCast 发射端 SDK 接口文档(Harmony 平台) |
| 隐私政策 | https://www.bijienetworks.com/news/company/bjcast-sdk-privacy-policy |
| 合规使用说明 | https://www.bijienetworks.com/news/company/bjcast-sdk-compliance |
| CHANGELOG | CHANGELOG.md |
| LICENSE(Apache-2.0) | LICENSE |
联系我们
| 联系方式 | 信息 |
|---|---|
| 公司名称 | 苏州必捷网络有限公司 |
| 官网 | https://www.bijienetworks.com/ |
| 电子邮箱 | marketing@bijienetworks.com |
| 联系地址 | 苏州市相城区泰元路 100 号 宏能永乐科技园 2 楼 232 号 |
| 个人信息保护负责人邮箱 | marketing@bijienetworks.com |
| 问题反馈 | marketing@bijienetworks.com |
苏州必捷网络有限公司
2026 年 6 月 16 日
