> For the complete documentation index, see [llms.txt](https://polyv.gitbook.io/document/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://polyv.gitbook.io/document/docs/live/miniprogram/live-watch-miniprogram-sdk/articles/verify-next/overview.md).

# 授权认证

开发者如果不需要保利威 Saas 的观看条件验证功能时，可通过保利威 Api 接口生成观众授权令牌（以下统称 **授权令牌**），授权令牌验证传入后即可绕过观看条件限制进入直播观看页，详细用法可见以下文档：

## 一、处理流程

### 1.1 步骤1：创建观看核心实例

请参考 [观看页SDK-安装和初始化](https://git.polyv.net/help-center/document-center/-/blob/master/live/miniprogram/live_watch_miniprogram_sdk/articles/product/install/README.md)

### 1.2 步骤2：获取授权令牌

通过保利威 Api 接口获取观众授权令牌，接口文档可见：[获取观看页小程序 SDK 授权令牌](https://help.polyv.net/index.html#/live/api/channel/operate/get_watch_api_token)。

> 由于该接口涉及 appSecret 进行参数签名，建议该步骤由服务端生成。

### 1.3 步骤3：传入授权令牌

通过 **步骤2** 获取授权令牌后，通过核心实例的 `setXAuthToken` 方法传入授权令牌。

### 1.4 步骤4：安装观看核心实例

通过 **步骤3** 传入令牌后即可根据正常流程安装核心实例，注意关于授权令牌的流程仅在**首次安装**前需要，二次安装则不再需要该流程。

## 二、示例代码

以下为 js 方式的流程示例代码：

```js
import { send } from '@just4/ajax/ajax';
import md5 from 'md5';
import { createWatchCore } from '@polyv/live-watch-miniprogram-sdk';

/**
 * 生成签名
 * @param {Object} data 请求参数
 * @param {String} secret 签名密钥
 * @returns 签名串
 */
function getSign(data, secret) {
  let text = '';
  const keys = Object.keys(data).sort();

  for (const key of keys) {
    text += `${key}${data[key]}`;
  }
  const sign = md5(secret + text + secret);
  return sign.toUpperCase();
}

/**
 * 获取授权令牌
 * @param {string} channelId
 */
async function getWatchAuthToken({ channelId }) {
  // 请求数据
  const reqData = {
    appId: '应用 id，从管理后台获取',
    timestamp: Date.now(),
    channelId, // '频道ID',
    viewerId: '观众 id',
    nickname: '观众昵称',
    avatar: '观众头像',
  };
  // 应用密钥，从管理后台获取，建议获取授权令牌流程在服务端中进行，避免将应用密钥直接暴露在 js 中
  const appSecret = 'xxxxx';
  // 生成签名
  const sign = getSign(reqData, appSecret);
  reqData.sign = sign;

  // 通过 ajax 获取授权令牌
  const response = await send('//api.polyv.net/live/v3/channel/watch/get-watch-api-token', {
    method: 'post',
    data: reqData,
  });
  const result = response.data;
  return result.data.token;
}

// 示例方法
async function example() {
  const channelId = '频道号';

  // 步骤1：创建观看核心实例
  const watchCore = createWatchCore({ channelId });

  // 步骤2：获取授权令牌
  const watchAuthToken = await getWatchAuthToken({ channelId });

  // 步骤3：传入授权令牌
  watchCore.setXAuthToken(watchAuthToken);

  // 步骤4：安装观看核心实例
  await watchCore.setup();
}
```