1. 腾讯云短信服务开通

a. 点击前往腾讯云短信服务平台，点击免费开通；

b. 按照网页指引完成登录；

c. 按照您的需求，选择认证类型；

注：①个人&企业认证指引；②完成认证后，认证类型还可以在账号信息->账号中心进行更改。
d. 完成认证后，自动跳转至腾讯云短信工作台，点击“添加应用”。

e. 输入应用名称和应用简介，完成应用创建。

f. 创建完成后，点击应用名称，进入短信应用配置界面。

g. 按照下图指引，复制SDK AppID和App Key；

分别填写至直播后台“SDK AppID”和“App Key”处。
入口：开发设置-->短信平台设置。

2. 短信签名和短信正文模板创建

a. 短信签名和短信正文模板是什么？

b. 依次点击“国内短信”->“短信内容配置”->“创建签名”。

c. 选择签名类型，并根据系统要求填写剩余内容。

d. 签名创建成功后会在2小时内完成审核。待签名审核通过后，按照下图指引，复制签名内容，并填写至直播后台“短信签名”处。
入口：开发设置-->短信平台设置。

e. 依次点击“短信正文”->“创建短信模板”。

f. 输入模板名称和短信内容，点击“确认”，完成正文模板创建。

注：
①“短信内容”可设置为：欢迎观看本次直播，您的登录验证码是{1}。如非本人操作，请忽略此短信。
②当前POLYV仅支持短信模板中有一个模板变量，请勿输入多个模板变量。
g. 正文模板创建成功后会在2小时内完成审核。待模板审核通过后，按照下图指引，复制模板ID内容，并填写至直播后台“模板ID”处。
入口：开发设置-->短信平台设置。

3. 短信余量预警绑定

a. 依次点击“应用配置”->“通知与告警”->“添加告警联系人”。

b. 输入联系人姓名、手机、邮箱，点击“确定”。

c. 告警联系人添加成功后，联系人将可以及时收到短信余量不足等预警。
您还可以在“套餐包管理”->“修改预警”中收到预警的短信余量阙值。

通过以上3步，即可完成保利威直播后台的短信平台设置。设置完成后，可以开启手机号码中短信验证的开关，在观看页中测试是否已经生效。

阿里云短信服务新手指南

1. 注册短信服务商的企业账号

a. 点击前往阿里云注册入口。填写会员名、登录密码即可完成注册；

b. 您也可点击右上角的“快捷登录”，用阿里云、淘宝等其他账号进行登录。

2. 进行实名认证

a. 点击前往实名认证入口，若您已经完成实名验证，可以忽略这一步。
b. 如何进行认证？
-如何选择实名认证方式？
-个人用户如何完成实名认证？
-企业如何完成实名认证？
-事业单位、学校、机关、政府、社会团体如何完成实名认证？

3. 开通短信服务

a. 点击前往开通短信服务入口，勾选统一协议，并点击立即开通。

4. 创建AccessKey

a. 入口：管理控制台-->AccessKey-->选择“继续使用AccessKey”或“开始使用子用户AccessKey”。

b. 点击创建AccessKey，将AccessKey ID与 AccessKey Secret填写至保利威直播后台“AccessKey ID”和“AccessKey Secret”处。
入口：开发设置-->短信平台设置

5. 创建签名和模板

a. 什么是“短信签名”、“短信模板”？

b. 创建签名入口：短信服务控制台-->国内消息-->签名管理-->添加模板

c. 点击添加签名，填写“签名”，选择“签名用途”，选择是否“三证合一”，上传证明文件，点击确认后，会在签名管理中显示添加的签名。

添加的签名会在2小时内审核，在“审核状态”中会显示是否通过审核。
若未通过审核，可点击“操作”下的原因查看未审核通过的原因。

d. 将通过审核的签名填写至直播后台“短信签名”处。
入口：开发设置-->短信平台设置-->短信签名

e. 创建模板入口：短信服务控制台-->国内消息-->模板管理-->添加模板

f. 点击“添加模板”，选择“模板类型”，填写“模板名称”、“模板内容”、“申请说明”。

g. 提交后，该模板会在2小时内审核，审核成功的模板状态为“通过”。

将通过审核的模板code填写至直播后台“模板code”处。入口：开发设置-->短信平台设置-->模板code

6. 绑定手机号码

a.入口：管理控制台-->国内消息设置→绑定手机号码
b.为什么要绑定手机号码？
当套餐内的短信剩余数量到达预警时，阿里云平台会通知绑定的手机号。

通过以上6步，即可完成保利威直播后台的短信平台设置。设置完成后，可以开启手机号码中短信验证的开关，在观看页中测试是否已经生效。

一、功能路径

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

二、功能介绍

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

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（头像）、actor（用户头衔名称，非必须）、actorFColor（用户头衔字体颜色，非必须，请使用CSS Hex值带#号）、actorBgColor（用户头衔背景颜色，非必须，请使用CSS Hex值带#号）、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("保利威")); //学员的昵称
$marqueeName     = urlencode(base64_encode("polyv")); //自定义跑马灯内容
$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 . "&marqueeName=" . $marqueeName. "&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加密，否则可能会造成观看页昵称显示乱码现象。

一、功能路径

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

二、功能介绍

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

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（学员头像）、actor（用户头衔名称，非必须）、actorFColor（用户头衔字体颜色，非必须，请使用CSS Hex值带#号）、actorBgColor（用户头衔背景颜色，非必须，请使用CSS Hex值带#号）等参数以json格式返回给直播系统。如果验证不通过，则将status（返回状态）、errorUrl（用户自定义错误页面）等参数返回给直播系统。
5. 直播系统接收用户API接口返回的数据，如果验证成功，则进入到保利威视直播观看页，聊天区将显示学员的昵称和头像。如果验证失败，则给出错误提示。

流程图如下

四、参数说明

注意事项：在使用普通直播观看页时，同时传入了nickname和marqueeName，在观看日志中，marqueeName将作为用户昵称的统计字段

五、代码示例（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" => "保利威", //学员昵称
        "marqueeName" => "polyv", //自定义跑马灯字段
        "avatar"   => "http://live.polyv.net/assets/images/avatars/9avatar.jpg", //学员头像
        "actor"   => "VIP",  // 学员头衔，可以不传递
        "actorFColor"   => "#5C96E5",  // 学员头衔字体颜色，可以不传递
        "actorBgColor"   => "#FFFFFF"   // 学员头衔背景颜色，可以不传递
    );
    $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只能使用一次，使用后需重新生成。