初始化
1. 引入sdk文件
// 播放器依赖于Promise,兼容ie及其它低版本浏览器的用户需添加polyfill, 如下:
<script src="//static.mudu.tv/es6-promise/es6-promise.auto.min.js"></script>
// 以下为必须添加项
<script>window.FETCHER_SERVER_URL = "ws://fetcher.mudu.tv";</script>
//https下请使用 <script>window.FETCHER_SERVER_URL = "wss://fetcher.mudu.tv";</script>
<script src="//static.mudu.tv/fetcher/bundle.6d7aca164d2389e8bea6.js"></script>
<script src="//static.mudu.tv/static/websdk/sdk.js"></script>
2. 初始化
支持以下几种方式使用频道id或频道hash_id初始化频道数据:
// 1. 使用频道数字id初始化:n_${id}
Mudu.Init(
// 频道id
'n_41988',
// 初始化完成的回调函数,无参数
function () {
console.log('Mudu Web Sdk 初始化成功,频道id:41988')
}
)
// 2. 使用频道hash id字符串初始化:s_${hsahId}
Mudu.Init(
// 频道hash id
's_mv750pd9',
// 初始化完成的回调函数,无参数
function () {
console.log('Mudu Web Sdk 初始化成功,频道hash_id:mv750pd9')
}
)
// 3.如果没有id类型前缀,则认为是频道数字id
Mudu.Init(
// 频道id
41988,
// 初始化完成的回调函数,无参数
function () {
console.log('Mudu Web Sdk 初始化成功,频道id:41988')
}
)
为确保频道数据准确,请尽量使用前两种初始化参数。
3. 获取观众信息
在sdk 初始化成功后才可以获取当前的用户信息
Mudu.Room.User.GetUser()
- 返回OBJECT参数说明
名称 | 说明 | 类型 |
---|---|---|
name | 用户名 | string |
avatar | 头像地址 | string |
id | 目睹唯一身份标志,自动生成 | number |
assign_id | B端绑定的身份标志 | string |
4. 设置观众
sdk初始化时会默认初始化一个匿名观众身份,如果希望给匿名用户赋予身份 或 更新当前用户的头像、昵称等信息
// 需要在 sdk 初始化成功后才能使用
// 使用时需要按顺序传入name, avatar, assignId参数,如果需要更灵活传入参数,请使用Mudu.Room.User.AssignInfo()方法
Mudu.Room.User.Assign(name, avatar, assignId, Callback)
- 接口参数说明
名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
name | string | 是 | 昵称 |
avatar | string | 是 | 头像地址,传空值会使用目睹系统的头像 |
assignId | string | 是 | B端身份标识,频道内唯一 |
Callback | function(newUserInfo:object){} | 否 | Assign成功后的回调函数 |
// 需要在 sdk 初始化成功后才能使用
Mudu.Room.User.AssignInfo(userInfo, Callback)
- 接口参数说明
名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
userInfo | object | 是 | 观众信息object |
Callback | function(newUserInfo:object){} | 否 | Assign成功后的回调函数 |
- userInfo 参数说明
名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
assignId | string | 是 | B端身份标识,频道内唯一 |
name | string | 是 | 昵称 |
avatar | string | 否 | 头像,不传则使用系统默认图片 |
phone | string | 否 | 观众手机号 |
注意:
- 若不设置观众头像,系统将随机生成观众信息。
- 系统生成规则:avatar会使用目睹系统的头像
- 匿名观众不能参与投票(无assignId信息即为匿名观众)