自定义授权

一、功能路径

我的直播 --> 频道设置-->观看条件设置-->自定义授权

二、功能介绍

打开直播观看页时,直播系统会调用客户系统的验证接口,客户自定义验证逻辑,验证通过后才能打开保利威视直播观看页,并且接口返回的观众账号具有唯一性,即同一个账号不能在两个地方同时登录,较早登录的账号会被踢出。
customAuth

  1. Secretkey:用于校验签名的生成。
  2. 自定义URL:用于自定义授权验证的API接口。

三、自定义授权流程详解

  1. 在自定义URL处填写用户的授权验证API接口,需要完整的不带参数的url地址(不能是localhost等本地服务器地址,且不能带 ? 号),如:http://myWebsite.com/auth。
  2. 直播系统会将id(直播的频道)、ts(当前时间的毫秒级时间戳)、sign(用于校验的签名)、url(回调的url地址)等参数提交给用户自定义的API接口,用户需要对字符串secretkey + id + secretkey + ts进行MD5加密后与sign参数的值做比较判断是否合法。
  3. 通过校验和自定义验证逻辑后,客户系统将userid(学员唯一标识)、nickname(昵称)、avatar(头像)、ts(当前时间的毫秒级时间戳)、sign(校验签名)等参数提交到回调的url接口。
  4. 直播系统会对签名做校验后判断是否允许学员观看.校验通过后将进入直播观看页,聊天区域将显示观众的昵称和头像。一次成功请求后,该链接将失效。

流程图如下

自定义授权流程图

四、参数说明

自定义授权观看参数说明

五、代码示例(PHP)

<?php
$secretkey = "jlw42byyJ6"; //后台secretKey,在自定义授权地址设置页面
$id        = $_GET["id"]; //直播的频道id
$ts        = $_GET["ts"]; //当前时间
$sign      = $_GET["sign"]; //用于检验的签名
$url       = $_GET["url"]; //回调的url
$md5       = md5($secretkey . $id . $secretkey . $ts); //若md5字符串与sign不符合,则不做任何处理
if (!($sign == $md5)) {
    return;
}
$userid       = "eciyhturt8"; //学员唯一标识
$nickname     = urlencode(base64_encode("保利威视")); //学员的昵称
$avatar       = "http://live.polyv.net/assets/images/avatars/9avatar.jpg"; //学员的头像
$callbackTs   = time() * 1000; //当前的系统时间
$callbackSign = md5($secretkey . $id . $secretkey . $callbackTs . $secretkey . $userid); //用于检验的签名
$callbackUrl  = $url . "?userid=" . $userid . "&nickname=" . $nickname . "&avatar=" . $avatar . "&ts=" . $callbackTs . "&sign=" . $callbackSign; //新的直播页面url
//打开新的直播页面url
echo "<script language='javascript' type='text/javascript'>location.href='" . $callbackUrl . "'</script>"
?>

六、展示效果

http://live.polyv.cn/watch/104400

七、注意事项

  1. .要保证自定义验证接口返回的userid的唯一性,当多个观众使用同一个userid进入观看页时,较早登录的观众会被后面登录的观众踢出,观看页会提示 "帐号在另外的地方登录,您将被退出观看。"如下图:
    退出观看提示

  2. 学员的昵称进行base64加密后再进行urlencode加密,否则可能会造成观看页昵称显示乱码现象。

以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

外部授权

一、功能路径

我的直播 --> 频道设置-->观看条件设置-->外部授权

二、功能介绍

打开直播观看页的时候URL需带上指定的参数,经过直播系统验证请求合法后,直播系统会调用客户在后台设置的自定义授权验证接口,进行外部授权验证,两次验证通过,才能进入直播观看页,并且接口返回的观众账号具有唯一性,即同一个账号不能在两个地方同时登录,较早登录的账号会被踢出。
externalAuth1

  1. Secretkey:用于校验签名的生成。
  2. 自定义URL:用于外部授权验证的API接口。
  3. 跳转地址:观众直接访问Polyv观看页,会跳转到该地址;若跳转地址为空,则显示默认提示页。

三、外部授权流程详解

  1. 在自定义URL处填写用户的授权验证API接口,需要完整的不带参数的url地址(不能是localhost等本地服务器地址,且不能带 ? 号),如:http://myWebsite.com/auth。
  2. 在请求保利威视直播观看页时需带上userid(用户ID)、ts(当前时间的毫秒级时间戳)和sign(用于校验的签名,生成规则是secretkey + userid + secretkey + ts进行MD5加密),如https://live.polyv.cn/watch/125527?userid=6b3a43&ts=1498547407000&sign=dd9dc9e42ad7c0204398e925a4ee0f46
  3. 直播系统会对字符串secretkey+userid+secretkey+ts进行MD5加密后与用户提交的sign参数的值做比较判断是否合法。一次成功请求后,该链接将失效(sign只能成功使用一次)。如果合法,直播系统将调用用户的api接口,并把userid(用户ID)、ts(当前时间的毫秒级时间戳)和token(用于校验的签名)三个参数传给用户。如果不合法,则给出错误提示。
  4. 用户API接口获取userid、ts和token参数后,进行外部授权验证。如果验证通过,则将status(返回状态)、userid(学员唯一标识)、nickname(学员昵称)、avatar(学员头像)等参数以json格式返回给直播系统。如果验证不通过,则将status(返回状态)、errorUrl(用户自定义错误页面)等参数返回给直播系统。
  5. 直播系统接收用户API接口返回的数据,如果验证成功,则进入到保利威视直播观看页,聊天区将显示学员的昵称和头像。如果验证失败,则给出错误提示。

流程图如下

外部授权流程图

四、参数说明

外部授权参数

五、代码示例(PHP)

<?php
header("Content-type:application/json;charset=UTF-8"); //媒体格式类型为JSON数据格式
$secretkey = "aDrOt0Cpy8";
$userid    = isset($_GET["userid"]) ? $_GET["userid"] : "";
$ts        = isset($_GET["ts"]) ? $_GET["ts"] : "";
$token     = isset($_GET["token"]) ? $_GET["token"] : "";
$sign      = md5($secretkey . $userid . $secretkey . $ts);

//用户进行授权验证,返回对应的数据(json格式)
if ($sign == $token) {
    //验证正确
    $array1 = array(
        "status"   => 1, //返回状态
        "userid"   => $userid, //学员唯一标识
        "nickname" => "保利威视", //学员昵称
        "avatar"   => "http://live.polyv.net/assets/images/avatars/9avatar.jpg", //学员头像
    );
    $json1 = json_encode($array1);
    echo $json1;
} else {
    //验证错误
    $array0 = array(
        "status"   => 0,
        "errorUrl" => "http://xxx.xx.xxxx/error.html", //验证错误跳转的自定义页面
    );
    $json0 = json_encode($array0);
    echo $json0;
}

六、展示效果

http://demo.polyv.net/chenwb/open.php

七、注意事项

  1. .要保证自定义验证接口返回的userid的唯一性,当多个观众使用同一个userid进入观看页时,较早登录的观众会被后面登录的观众踢出,观看页会提示 "帐号在另外的地方登录,您将被退出观看。"如下图:
    被踢

  2. 自定义验证接口需要填写完整的URL地址,且不能是localhost等本地服务器地址。

  3. 自定义验证接口返回给直播系统的数据格式是json格式。

八、错误提示

  1. user not found:请求自定义验证接口错误,或者接口返回的格式不对。
  2. invalid sign:签名错误,sign的生成规则是secretkey+userid+secretkey+ts进行MD5加密。
  3. sign expired:签名过期,每一个sign只能使用一次,使用后需重新生成。
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

验证码观看

一.功能途径

云直播-->我的直播-->视频设置--> 观看条件设置->验证码观看

白名单观看验证码观看1

二.功能介绍

  • 验证码观看即输入正确的验证码即可观看直播,该验证码是唯一确定的。
  • 验证码获取:扫客户的公众号进行获取
  • 观看页中可直接输入正确的验证码进行或从客户公众号中获取验证码
  • 该观看条件可给公众号进行吸粉

三.使用步骤

验证码观看-->输入验证码-->上传公众号二维码(非必须操作)-->写弹窗的提示文案(非必须操作)-->保存

验证码观看4

PC端效果预览

验证码观看5验证码观看6

注意:验证码观看,二维码可上传也可不上传。
当上传二维码时,学员需扫二维码进入公众号,从公众号中获取;
当没有上传二维码时,学员输入客户提供的正确二维码即可观看直播

以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

登记观看

一.功能途径

云直播-->我的直播-->视频设置-->观看条件设置-->白名单观看

白名单观看登记观看

二.功能介绍

用户登记相关信息即可观看直播
最多可设置5条信息

三.使用步骤

登记观看-->添加信息-->填写信息标题与信息描述-->保存
登记观看2

在查看登记列表处可以查看登记的内容
登记观看3

注意:当选择信息类型为下拉选择的时候,选项详情最多为8个

登记观看4

以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

白名单观看

一.功能途径

云直播-->我的直播-->视频设置-->观看条件设置-->白名单观看
白名单观看白名单观看2

二.功能介绍

  • 处于白名单里的用户输入正确的验证后,可直接观看,可理解为设置VIP用户

三.使用步骤

白名单观看-->下载白名单模板(excel表格)-->输入白名单信息-->导入白名单-->保存

白名单观看3

可在查看白名单处查看白名单信息

白名单观看5

注意:导入白名单的白名单模板必须为制定的模板

以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

付费观看

一.功能途径

云直播-->我的直播-->视频设置-->观看条件设置

付费观看1付费观看2

二.功能介绍

  • 观众需要付费成功才能进入直播观看页
  • 付费有效期分为:
    • 一次性付费永久有效
    • 设置付费有效日期
    • 设置付费有效时长

三.使用步骤

云直播-->我的直播--> 频道设置--> 观看条件设置-->付费观看-->设置欢迎标题、观看价格、付费有效期

付费观看3

PC端预览效果

付费观看4

以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

观看条件设置总述

一.功能途径

云直播-->我的直播-->视频设置-->观看条件设置
观看条件设置3观看条件设置2

二.功能介绍

观看条件设置类型有:

  • 付费观看:付费后即刻观看
  • 白名单观看:在白名单内的用户可免费观看
  • 登记观看:根据要求填写完相关的内容即可观看
  • 验证码观看:输入正确的验证码即可观看
  • 自定义授权:验证学员后依然在保利威视的平台进行观看
  • 外部授权:学员观看跳转到客户自己的界面进行观看
  • 分享观看:分享至微信好友后即可观看

观看条件设置可设置为单条件以及双条件,但是双条件下的两个观看条件互斥;其次,分享观看仅在次要观看条件中可设置。

观看条件设置5

三.使用步骤

详细的使用步骤见观看条件设置的分述。

以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...