环境配置与权限申请

环境配置与权限申请

您需要先在小程序管理后台预先配置好环境才能正常使用SDK,以及使用腾讯提供的音视频插件

步骤一二 完成后,您将可以正常使用ImCamWxSDK。但仍无法正常使用音视频能力
步骤三 完成后,您将可以在小程序中正常使用xp2p插件进行小程序查看设备直播。但无法使用voip插件来实现设备呼叫小程序
步骤四五六 完成后,您将完全正常使用小程序的所有音视频能力。但还需激活设备license来授权设备正常与小程序建立VOIP音视频通道
步骤七 完成后,大功告成,所有小程序的环境配置需求便完成了。

一、配置服务器域名

  • 在小程序管理后台的【开发管理】->【配置服务器域名】中配置合法域名

request

https://jiafeigou-1251885898.cos.ap-guangzhou.myqcloud.com

socket

wss://fcn.jfgou.com:443

downloadFile

https://jiafeigou-1251885898.cos.ap-guangzhou.myqcloud.com;

配置服务器域名

二、将appid发送给赛蓝

  • 联系我们之后,赛蓝服务器会将appid加入白名单。加入白名单后方可调用SDK中的api

三、添加小程序插件

  • 在小程序后台的【设置】->【第三方设置】->【插件管理】中添加以下三个插件
    VOIP通话 / 摄像头P2P / p2pplayer
  • 由于这些插件需要腾讯侧那边批准后才能添加,所以您申请后需要联系我们,由我们联系腾讯人员去批准申请
  • 申请通过后,即可在小程序端引用相关的音视频通话插件了 申请插件

四、注册硬件设备

  1. 首先您需要进入小程序后台的【功能】->【硬件设备】页面,开通硬件设备权限
  2. 开通后,在【硬件设备】页面添加一个设备型号,添加之后需要等待腾讯侧验证
  3. 等待验证通过后,点击【申请设备能力】->申请【小程序音视频能力】
  4. 上述步骤完成后的显示如下 硬件设备
  5. 此时,您的小程序将获得10个VOIP音视频通话的设备测试license。您可以在【管理】->【付费管理】中看到详情 付费管理-测试license
  6. 此测试license的激活流程详见 激活设备体验license (opens in a new tab)

如果您的服务器拥有自主开发能力,可以参考腾讯文档进行激活,并且后续将与赛蓝服务器进行云云对接
如果您打算全权交给赛蓝来管理,需要移步至 配置小程序access_token服务器

五、授权腾讯iot video服务

  1. 您需要先联系我们,并等待我们联系到腾讯相关人员后,发给您一个二维码
  2. 当拿到二维码后,请使用管理员的微信账号扫码并完成授权
    请注意,扫码后请仅授权"硬件服务"这一项内容。其余内容不要授权,否则可能会影响到您小程序的正常使用

参考下图 授权腾讯iot-video

六、配置小程序access_token服务器

  • 首先,您需要了解:
    1. 登录ImCamWxSDK以及使用腾讯VOIP音视频呼叫,都需要获取小程序的openID (opens in a new tab)
    2. 腾讯VOIP音视频呼叫的前提,需要激活设备license (opens in a new tab)
    3. 腾讯VOIP音视频呼叫需要实时获取设备票据 (opens in a new tab)
  • 这两项数据的来源都是小程序对应的服务端数据
  • 如果您的服务端已具备此能力,且不想把AppSecret(小程序的重要令牌)交给赛蓝管理。您可以选择云云对接
  • 如果您想全权交给赛蓝来管理,请您参考下面的步骤将AppSecret交给赛蓝管理,并给赛蓝服务器的ip开放白名单,以授权赛蓝调用服务端API。
    1. 进入小程序管理后台的【开发】->【开发管理】页面,找到AppSecret,点击生成 生成AppSecret
    2. 生成过后,点击开启IP白名单,并将我们的服务器IP加入到白名单中

    请联系赛蓝相关人员,我们将提供IP列表给您

七、激活设备License

  1. 如果您的小程序采用自行管理服务端API,则请前往激活设备license (opens in a new tab)页面,激活正式或测试license
  2. 如果您打算交给赛蓝来管理服务端API,请通知我们激活license

(可选)八、设置基础库最低可用版本

  1. 由于音视频插件在低版本微信无法使用,所以建议您在小程序后台【设置】页面设置基础库最低版本为2.30.4

(可选)九、设置小程序隐私协议

  1. 如果只是用体验版进行调试时,不需要设置隐私协议
  2. 如果您需要上线小程序(调试VOIP能力时,必须要上线小程序才能调试),则在申请提交上线时,管理后台应该会提醒您更新隐私政策
  3. 根据您用到SDK的内容,请自行参考我们的示例来填写 隐私政策
© 2024 Cylan