环境配置与权限申请
您需要先在小程序管理后台预先配置好环境才能正常使用SDK,以及使用腾讯提供的音视频插件
步骤一二 完成后,您将可以正常使用ImCamWxSDK。但仍无法正常使用音视频能力
步骤三 完成后,您将可以在小程序中正常使用xp2p插件进行小程序查看设备直播。但无法使用voip插件来实现设备呼叫小程序
步骤四五六 完成后,您将完全正常使用小程序的所有音视频能力。但还需激活设备license来授权设备正常与小程序建立VOIP音视频通道
步骤七 完成后,大功告成,所有小程序的环境配置需求便完成了。
一、配置服务器域名
- 在小程序管理后台的【开发管理】->【配置服务器域名】中配置合法域名
request
https://jiafeigou-1251885898.cos.ap-guangzhou.myqcloud.comsocket
wss://fcn.jfgou.com:443downloadFile
https://jiafeigou-1251885898.cos.ap-guangzhou.myqcloud.com;
二、将appid发送给赛蓝
- 联系我们之后,赛蓝服务器会将appid加入白名单。加入白名单后方可调用SDK中的api
三、添加小程序插件
- 在小程序后台的【设置】->【第三方设置】->【插件管理】中添加以下三个插件
VOIP通话 / 摄像头P2P / p2pplayer - 由于这些插件需要腾讯侧那边批准后才能添加,所以您申请后需要联系我们,由我们联系腾讯人员去批准申请
- 申请通过后,即可在小程序端引用相关的音视频通话插件了

四、注册硬件设备
- 首先您需要进入小程序后台的【功能】->【硬件设备】页面,开通硬件设备权限
- 开通后,在【硬件设备】页面添加一个设备型号,添加之后需要等待腾讯侧验证
- 等待验证通过后,点击【申请设备能力】->申请【小程序音视频能力】
- 上述步骤完成后的显示如下

- 此时,您的小程序将获得10个VOIP音视频通话的设备测试license。您可以在【管理】->【付费管理】中看到详情

- 此测试license的激活流程详见 激活设备体验license (opens in a new tab)
如果您的服务器拥有自主开发能力,可以参考腾讯文档进行激活,并且后续将与赛蓝服务器进行云云对接
如果您打算全权交给赛蓝来管理,需要移步至 配置小程序access_token服务器
五、授权腾讯iot video服务
- 您需要先联系我们,并等待我们联系到腾讯相关人员后,发给您一个二维码
- 当拿到二维码后,请使用管理员的微信账号扫码并完成授权
请注意,扫码后请仅授权"硬件服务"这一项内容。其余内容不要授权,否则可能会影响到您小程序的正常使用
参考下图
六、配置小程序access_token服务器
- 首先,您需要了解:
- 登录ImCamWxSDK以及使用腾讯VOIP音视频呼叫,都需要获取小程序的openID (opens in a new tab)
- 腾讯VOIP音视频呼叫的前提,需要激活设备license (opens in a new tab)
- 腾讯VOIP音视频呼叫需要实时获取设备票据 (opens in a new tab)
- 这两项数据的来源都是小程序对应的服务端数据
- 如果您的服务端已具备此能力,且不想把AppSecret(小程序的重要令牌)交给赛蓝管理。您可以选择云云对接
- 如果您想全权交给赛蓝来管理,请您参考下面的步骤将AppSecret交给赛蓝管理,并给赛蓝服务器的ip开放白名单,以授权赛蓝调用服务端API。
- 进入小程序管理后台的【开发】->【开发管理】页面,找到AppSecret,点击生成

- 生成过后,点击开启IP白名单,并将我们的服务器IP加入到白名单中
请联系赛蓝相关人员,我们将提供IP列表给您
- 进入小程序管理后台的【开发】->【开发管理】页面,找到AppSecret,点击生成
七、激活设备License
- 如果您的小程序采用自行管理服务端API,则请前往激活设备license (opens in a new tab)页面,激活正式或测试license
- 如果您打算交给赛蓝来管理服务端API,请通知我们激活license
(可选)八、设置基础库最低可用版本
- 由于音视频插件在低版本微信无法使用,所以建议您在小程序后台【设置】页面设置基础库最低版本为2.30.4
(可选)九、设置小程序隐私协议
- 如果只是用体验版进行调试时,不需要设置隐私协议
- 如果您需要上线小程序(调试VOIP能力时,必须要上线小程序才能调试),则在申请提交上线时,管理后台应该会提醒您更新隐私政策
- 根据您用到SDK的内容,请自行参考我们的示例来填写

