差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 | ||
|
im:applet:multiuserconference [2020/02/14 02:42] zhangdong [接口说明] |
im:applet:multiuserconference [2020/06/25 02:31] allenwang 移除 |
||
|---|---|---|---|
| 行 1: | 行 1: | ||
| - | ====== 集成文档 ====== | + | ====== 多人音视频会议 ====== |
| + | |||
| + | ------ | ||
| **多人音视频SDK**基于微信小程序live-pusher、live-player组件， | **多人音视频SDK**基于微信小程序live-pusher、live-player组件， | ||
| - | 小程序实时音视频目前只支持多人音视频会议，尚不支持1对1的通话，如果有1对1的需求也可以用多人会议的场景去实现，相当于会议中只有两个人。音视频SDK依赖IM SDK，所以集成前要先集成IM，把IM SDK放在全局变量wx下，let WebIM = wx.WebIM = require('sdk/connection')，可以参考[[https://github.com/easemob/webim-weixin-xcx|demo]]中src/comps/chat/multiEmedia的集成。 | + | 音视频SDK依赖IM SDK，所以集成前要先集成IM，把IM SDK放在全局变量wx下，let WebIM = wx.WebIM = require('sdk/connection')，可以参考[[https://github.com/easemob/webim-weixin-xcx|demo]]中src/comps/chat/multiEmedia的集成。 |
| - | ==== 下载 ==== | + | **注意：** 小程序创建的会议支持其他端加入（Android，iOS，Web，桌面端）， 但是其他端创建的会议要在创建时选择支持小程序，小程序端才可以加入会议，否则无法互通。 |
| + | |||
| + | ===== 准备 ===== | ||
| + | |||
| + | * 下载微信开发者工具 | ||
| + | * 在微信公众平台配置服务器域名: | ||
| + | * request 合法域名: [[https://mprtc.easemob.com]] | ||
| + | * socket 合法域名: [[wss://mprtc.easemob.com]] | ||
| + | * 确保微信小程序符合使用媒体组件相应的类目并开通实时音视频权限 | ||
| + | * 使用微信小程序基础库 1.7.0 及以上版本 | ||
| + | |||
| + | ===== 下载 ===== | ||
| 下载**emedia_for_miniProgram.js**。 | 下载**emedia_for_miniProgram.js**。 | ||
| 行 11: | 行 25: | ||
| 音视频SDK在src/emedia/emedia_for_miniProgram.js | 音视频SDK在src/emedia/emedia_for_miniProgram.js | ||
| - | ==== 集成 ==== | + | ===== 集成 ===== |
| 直接引用js： 拷贝文件 emedia_for_miniProgram 到小程序工程文件夹，使用 require 将 SDK 集成到项目中即可： | 直接引用js： 拷贝文件 emedia_for_miniProgram 到小程序工程文件夹，使用 require 将 SDK 集成到项目中即可： | ||
| <code javascript> | <code javascript> | ||
| 行 25: | 行 39: | ||
| }) | }) | ||
| </code> | </code> | ||
| + | |||
| + | **请注意：在其他端创建会议时，需要指定支持小程序音视频，才能与小程序互通。** | ||
| + | |||
| == 2.加入会议 == | == 2.加入会议 == | ||
| <code javascript> | <code javascript> | ||
| 行 72: | 行 89: | ||
| 3.有媒体流添加；比如有人调用pubStream之后。 | 3.有媒体流添加；比如有人调用pubStream之后。 | ||
| <code javascript> | <code javascript> | ||
| - | emedia.mgr.onStreamAdded = function (member, stream) {}; | + | emedia.mgr.onStreamAdded = function (stream) {}; |
| </code> | </code> | ||
| 4.有媒体流移除； | 4.有媒体流移除； | ||
| <code javascript> | <code javascript> | ||
| - | emedia.mgr.onStreamRemoved = function (member, stream) {}; | + | emedia.mgr.onStreamRemoved = function (stream) {}; |
| </code> | </code> | ||
| 5.角色改变； | 5.角色改变； | ||
| 行 82: | 行 99: | ||
| emedia.mgr.onRoleChanged = function (role) {}; | emedia.mgr.onRoleChanged = function (role) {}; | ||
| </code> | </code> | ||
| - | 6.会议退出；自己主动退出，服务端主动关闭； | + | 6.媒体流发生变化 (比如有人关闭摄像头) |
| + | <code javascript> | ||
| + | emedia.mgr.onMediaChanaged = function (stream) {}; | ||
| + | </code> | ||
| + | 7.会议退出；自己主动退出，服务端主动关闭； | ||
| <code javascript> | <code javascript> | ||
| emedia.mgr.onConferenceExit = function (reason, failed) { | emedia.mgr.onConferenceExit = function (reason, failed) { | ||
| 行 297: | 行 318: | ||
| }) | }) | ||
| </code> | </code> | ||
| + | |||
| + | ===== 质量检测 ===== | ||
| + | 在视频或者语音过程中如果质量不好，可以根据[[https://developers.weixin.qq.com/miniprogram/dev/component/live-player.html|小程序官方文档]]给出的回调，或者在<live-player>、<live-pusher>组件加上debug=true来监测网络状态数据，调整相应参数。推荐max-bitrate为500，语音质量不好可以适当增加min-cache、max-cache值。 | ||