集成 SDK

更新时间: 2023/06/29 03:39:26

本文为您展示通过 NEMeetingKit 实现音视频会议的相关步骤,帮助您在业务中实现创建会议、预约会议、查询会议信息等在线会议场景下的相关能力。

前提条件

在开始运行示例项目之前,请确保您已完成以下操作:

  • 创建应用开通 NERoom 房间组件能力,并选择了线上会议场景模板。

  • 已在网易云信控制台的应用列表中获取指定应用的 App Key。

  • 微信小程序相关操作:

    • 已注册微信小程序账号,并通过企业认证,并在【微信公众平台】 >【开发】>【开发管理】>【接口设置】中打开实时播放音视频流和实时录制音视频流的开关,以自助开通该组件权限。

    authority.jpg

    出于政策和合规的考虑,微信暂未放开所有小程序对实时音视频功能(即 live-pusherlive-player 标签)的支持,仅指定类目的应用可以开通小程序推拉流标签。

    • 已在微信小程序中创建微信的 live-pusher 组件和 live-player 组件,分别实现音视频播放和音视频录制功能。
  • 已部署安装微信的移动端设备以供调试和运行体验。

开发环境

在客户端实现音视频会议功能之前,请您准备以下开发环境:

名称 具体要求
Android 端的微信 App 7.0.8 及以上版本
iOS 端的微信 App 7.0.9 及以上版本
小程序基础库 2.10.0 及以上版本
微信开发者工具 最新版本
  • 由于微信开发者工具不支持原生组件(即 < live-pusher 和 < live-player > 标签),需要在真机上进行运行体验。
  • 由于小程序测试号不具备 < live-pusher 和 < live-player > 的使用权限,需要申请常规小程序账号进行开发。
  • 暂不支持 uniapp 开发环境,请使用原生小程序开发环境。

配置白名单并打开端口

如果您的网络环境部署了防火墙,请在【微信公众平台】 >【开发】>【开发管理】>【开发设置】中将以下域名及对应端口添加到域名白名单中。

配置白名单.png

域名:

# http接口
https://statistic.live.126.net
https://lbs.netease.im
https://nrtc.netease.im
https://wlnimsc0.netease.im
https://wlnimsc1.netease.im
https://roomkit.netease.im
# websocket接口
wss://webrtcgwcn.netease.im
wss://webrtcgwhz.netease.im

端口:

目标端口 协议 操作
80;443 TCP 允许
30000 ~ 40000 UDP 允许

集成 SDK

  1. 引入 NEMeetingKit 和 NEChatRoomUI 两个文件夹 至 components 文件。

  2. 在使用会议组件的 page 中引入组件。

    由于手机屏幕限制,需要配置屏幕旋转参数为横屏,示例代码如下。

    // xxx.json
    {
        "pageOrientation": "landscape", // 设置为横屏
        "usingComponents": {
            "NEMeetingKit": "../../components/NEMeetingKit/NEMeetingKit" // 组件所在路径
        }
    }
    
  3. 使用组件。

    // xxx.wxml
    <NEMeetingKit 
        id="meeting-component" 
        bindmeetingClosed="onMeetingClosed"
        binddisconnect="onDisconnect"
        bindkicked="onKicked"
        bindleave="leaveRoom" 
        bindonLoginStateChange="onLoginStateChange">
    </NEMeetingKit>
    
此文档是否对你有帮助?
有帮助
去反馈
  • 前提条件
  • 开发环境
  • 配置白名单并打开端口
  • 集成 SDK