You need to enable JavaScript to run this app.
导航

客户端播放

最近更新时间2023.11.03 17:38:11

首次发布时间2021.03.22 11:43:04

本文主要介绍通过播放临时安全凭证 PlayAuthToken 播放的播放流程、对接流程。

简介

客户端播放是指通过终端(Android、iOS、Web)播放音视频。视频点播提供了播放 SDK,您可以集成视频点播播放器完成视频播放。

  • App/Web Client 向 App/Web Server 获取播放临时安全凭证PlayAuthToken 用于播放,安全性较高,支持 Android、iOS、Web 三端。
  • 您也可以直接获取播放地址播放,将播放地址传递给视频点播播放 SDK 进行播放。
  • 如果您没有使用视频点播服务端能力,您也可以使用客户端播放任意播放链接。

前提条件

已开通 IAM 账号并授权视频点播权限。提前准备账号的 AK/SK,支持主账号、(推荐)子账号。详细操作请参见创建 IAM 子账号并授权

  • (推荐)子账号:在访问控制中创建一个子账号,并授权点播权限后,创建子账号下的 AK/SK。
  • 主账号:在访问控制中创建主账号的 AK/SK。

注意

主账号拥有账号下全部权限,若泄漏可能给您的服务带来很大风险,不推荐直接使用主账号 AK/SK 调用服务。

机制说明

App/Web Client 播放时,App/Web Client 直接向点播服务请求播放地址,需要和点播服务直接交互,此时点播服务会对客户端的请求进行鉴权。由于长期的 SecretKey 的权限过大,您千万不要将 SecretKey 泄露到客户端,否则将可能造成严重的安全问题。因此,需要您搭建 App/Web Server 授权服务,通过 App/Web Server 和 App 间的信息通道来传递播放临时安全凭证。

说明

App/Web Client 向 App/Web Server 申请播放临时安全凭证时,请务必对用户身份做校验,否则任何人都可以拿到安全凭证获取到播放地址。

播放临时安全凭证 PlayAuthToken 机制的主要特点:

  • 无需依赖外网服务:由 App/Web Server 持有的 AK/SK 在本地签出,不依赖外网。若希望同时生成多个 Vid 对应的PlayAuthToken,您可以循环调用生成方法;
  • 安全性高:严格限制时效、限制访问对象;
  • 使用简单:通过 AK/SK 按标准方法签出即可;
  • 配置灵活:支持对使用参数进行灵活的签名和验签。

播放流程

image

主要流程如下所示。

  1. App/Web Client 向 App/Web Server 发起请求获取播放临时安全凭证 PlayAuthToken
  2. App/Web Server 本地方法签出播放临时安全凭证 PlayAuthToken,并返回给 App/Web Client;
  3. App/Web Client 将播放临时安全凭证 PlayAuthToken 传递给点播 SDK;
  4. 点播 SDK 利用播放临时安全凭证 PlayAuthToken 向视频点播发起请求,获取播放信息;
  5. 视频点播返回播放信息,包括播放地址等。

使用说明

  • 播放临时安全凭证 PlayAuthToken 是一个播放凭证,不是实际播放地址。点播 SDK 会根据播放凭证自动获取播放地址进行播放。

  • 播放临时安全凭证 PlayAuthToken 中带有 Vid、Format 等音视频信息,只能用于获取指定的音视频的播放地址,不能混用。即不同的 Vid、Format,您需要获取不同的 PlayAuthToken

  • 播放临时安全凭证 PlayAuthToken 默认有效时间是 900s,生成时可以指定生效时间。如果凭证过期无法获取到播放地址,需要重新获取播放临时安全凭证。

    注意

    此有效时间只是凭证生效时间,不代表获取到的播放地址的生效时间。播放地址生效时间仍取决于时间戳防盗链设置的时间。

  • 服务端生成播放临时安全凭证的方法为本地方法,您不需要关心 API 的耗时。

开发对接

播放前准备工作及播放前提,详情请见:媒资播放概述

服务端 SDK

为方便您的使用,我们对播放临时安全凭证 PlayAuthToken 使用进行了封装,提供了多语言的 SDK。建议您使用服务端 SDK 来调用。

客户端集成

我们提供 Android、iOS、Web 的点播 SDK,详情请见点播 SDK 介绍