身份赋予API

功能说明

身份赋予API可以在客户在直播时,指定观众以特定身份观看直播,如将自身平台的观众身份传递到直播页面,让观众获得无缝的体验。

特别说明:如果您选用了此API,那么微信打赏,付费观看等涉及微信的功能将暂不可用

身份赋予逻辑图

身份赋予逻辑图

接口说明

请求header

GET http://{your-domain}/activity.php?a=userAssign

注:请将 {your-domain} 替换为您的域名,或者 mudu.tv

参数说明

参数 参数说明 参数类型 是否必填 备注
id 频道id integer 频道id是控制台进入频道
直播控制页面后,url中的id参数
assign_id 观众唯一身份标识ID string 如果传此参数,务必要保证其唯一性
name 观众昵称 string
avatar 观众头像url string
key 自定义加密key string key生成方法见下方
expire 过期时间(秒) integer 默认为7天,如想指定有效期为1小时,则传3600
注意,最大值为2147483647,否则无效
phone 手机号 string
tourl 指定的观看页地址 string 观看页地址必须为当前频道,即地址中的频道ID要与上方ID一致。若需要记录分享信息或其他额外信息,请将观看页跳转到自定义授权页的notify_url参数填入该字段

key的生成方法(以PHP为例):

$assign_id  = 'my_company_user_12345';
$authKey = 'ABCDEFG';
$key     = md5($assign_id.$authKey);
注:此处的 `$authKey` 请在 `某个频道 - 频道管理 - 授权观看 - 授权类型 - 自定义授权` 中获取
所有参数都必须urlencode

PHP DEMO

# 直播频道ID:         12345
# 观众唯一身份标识ID:  my_company_user_12345
# 观众名称:           我的公司_观众A
# 观众头像:           http://your-domain/avatar.png
# 密钥:               ABCDEFG

<?php
$params = [
    'id'     => '12345',
    'assign_id' => 'my_company_user_12345',
    'name'   => '我的公司_观众A',
    'avatar' => 'http://your-domain/avatar.png',
    'key'    => md5('my_company_user_12345ABCDEFG')
];
header('Location:http://mudu.tv/activity.php?a=userAssign&'.http_build_query($params));
注:
http_build_query方法会将参数url编码,因此用http_build_query方法无需将参数url编码。

results matching ""

    No results matching ""