Tencent Cloud

Recent Pages

控制台指南

最后更新时间：2024-01-06 14:02:29
概览
腾讯云 StreamPackage 是腾讯云新发布的的高质量视频封装及源站平台。致力于为全球用户提供专业、稳定、安全的视频封装及交付服务，降低视频包装分发难度，增加源弹性（origin resiliency），允许视频供应商能够大规模安全稳定地分配视频流媒体。
StreamPackage 控制台基于 channel 维度进行管理，通过对视频内容进行重塑，将已经编码压缩好的视频轨和音频轨按照一定的格式放到直播源站中，使视频供应商能够大规模、安全、稳定地分配视频流媒体。
控制台概览
StreamPackage 控制台提供丰富、有用的功能以及简单灵活的访问体验。StreamPackage 控制台基于 channel 维度进行管理，整体可分为 Channel、Input、Endpoint、CDN 配置四个模块。
﻿
﻿
﻿
前提条件
用于 CDN 播放的域名（若需使用腾讯云直播 CDN 进行分发）。
已经 开通腾讯云直播服务。
登录 腾讯云 StreamPackage 控制台。
操作步骤
一、选择可用区
目前腾讯云 StreamPackage 已提供印度孟买、泰国曼谷、韩国首尔、日本东京、德国法兰克福、新加坡这几个可用区，您可在此选择您所在的地域。如果您有其它可用区的加速部署诉求请 联系我们。
﻿
﻿
﻿
二、创建 Channel
Channel 是 StreamPackage 输入流及输出流的基础配置，用户基于创建完成 Channel 可以输入既定协议的直播流，也可以创建相应的回源节点（Endpoint）供直播流输出分发。
1. 单击 Create Channel 创建新 Channel。
2. 输入 Channel Name，选择 Channel 输入协议（支持 HLS/DASH）。
﻿
3. 填写所选择的 HLS/DASH 协议相关参数。
Max Segment Duration 表示您朝此 Channel 推送 HLS/DASH 格式的流的 ts/m4s 切片的最大分片时长，该配置参数默认值为15s。
Max Playlist Duration 表示您朝此 Channel 推送 HLS/DASH 格式的流的 m3u8/mpd 列表的最大总时长，该配置参数的默认值为600s。您可根据您推流的m3u8/mpd 列表的实际情况进行修改。
说明
如果您创建的此 Channel 会同时推送主备通道两路流，以便于主流异常时实现快速切换备流，建议您将这个配置参数设置略大于分片的实际最大时长，从而实现更好地快速切换。
4. 点击 Create，完成创建。
三、查看 Channel
查看 Channel 信息
创建完毕后即跳转至 Channel 的详情页（点击 Channel 名字或右侧 Info 也可进入 Channel 详情页）。详情页会显示 Channel 的 Name、ID（由后台自动生成）、指定的输入协议及相关配置参数。同时会基于指定的协议自动生成两个输入点（Input）。
﻿
﻿
﻿
查看 Input
Input 是 Channel 输入的基本单位，后台会基于创建完成的 Channel 自动生成两个 Input 节点以及对应的输入 URL，用户可将直播流推到节点的 URL 中。
﻿
﻿
﻿
Input 模块支持 Authentication 操作，用户可对每个输入点独立做 Authentication 配置。用户点击操作栏的 Authentication 进入弹框，打开 Authentication 配置后，后台会对该输入节点自动生成 Username 和 Password，通过 http 认证模式进行鉴权。点击 Rotate credentials 完成 Authentication 配置。
﻿
﻿
﻿
注意
一旦用户 Rotate credentials，现有的 Channel credential 将失效。
创建 Endpoints
用户可对每个 Channel 创建回源拉流 Endpoint 节点。
1. 单击 Create Endpoint 创建节点。
﻿
2. 输入 Endpoint Name，Endpoint Type 默认与 Channel 的输入协议相同。 另外，如果你的输入协议为 HLS，则额外可选 Type 为 CMAF，StreamPackage支持将 HLS 转封装为 CMAF（DASH 格式）。
﻿
﻿
﻿
如果你需要修改 Manifest Name, 请在 Manifest Name 中输入，默认值是 main。
﻿
﻿
﻿
注意
HLS 转封装为 CMAF（DASH 格式）暂时不支持 DRM 的输入。如果输入的 HLS m3u8 带有 SCTE-35 标签，这些 SCTE-35 标签不会出现在转封装后的 CMAF manifest 中。
3. 用户可根据需要选择是否开启 IP 黑白名单、Authkey 等功能。
IP 黑白名单：固定合法IP段进行推流，或者拒绝异常 IP 端推流。
支持配置 Authkey：支持 http-header 通过 X-TENCENT-PACKAGE 进行鉴权。
﻿
﻿
﻿
4. 如果你需要时移功能，可以开启 Time-shifted Viewing，以开启时移功能。
﻿

Startover Windows：在多长时间内可以对直播进行时移回看。默认1天，还支持选择3天、7天、15天和30天。
开启时移后，直播切片将会被保存在云端，可以通过 Endpoint 的 URL 增加参数进行时移观看，具体参数如下：
timeshift=1，表示观看时移。
start=xxx，表示时移开始时间，支持 ISO 8601 dates 格式或者 POSIX (or Epoch) time 格式。
end=xxx，表示时移结束时间，支持 ISO 8601 dates 格式或者 POSIX (or Epoch) time 格式。
注意：
如果同时指定 start 和 end，那么 end 必须大于 start，否则会返回400错误。
start 必须在 StartoverWindows 范围内，否则会返回400错误。
最多只能返回24小时的时移内容，也就是 end 和 start 的时间差不能超过24小时，否则会返回400错误。
时移 URL 示例：
请求2023-07-01T00:00:00Z ~ 2023-07-01T23:59:59Z这段时间的时移内容
http://domain/v1/path/subpath/playlist.m3u8?timeshift=1&start=2023-07-01T00:00:00Z&end=2023-07-01T23:59:59Z
或者
http://domain/v1/path/subpath/playlist.m3u8?timeshift=1&start=1688169600&end=1688255999
请求2023-07-01T00:00:00Z开始的直播内容,直到直播结束
http://domain/v1/path/subpath/playlist.m3u8?timeshift=1&start=2023-07-01T00:00:00Z
或者
http://domain/v1/path/subpath/playlist.m3u8?timeshift=1&start=1688169600
注意
CMAF 类型的时移暂时不支持 SCTE-35。
5. 单击 Create 保存设置，创建完毕。创建完毕的 Endpoint 支持编辑及删除操作。用户可基于生成的 Endpoint URL 进行回源拉流操作，从而对直播流进行Distribution。
﻿
配置CDN分发
StreamPackage 支持在 Channel 中配置直播 CDN，配置完成后您可将 StreamPackage Channel 中的直播流直接通过直播 CDN 来进行分发。这需要您先开通云直播，并对 StreamPackage 与云直播完成双向授权操作。
在阅读以下内容前，解释相关名词：
直播 CDN：标准直播（LVB）中的 CDN，StreamPackage 整合复用了该项能力，让您 StreamPackage的Channel 中的直播流可以快速通过 LVB 的 CDN 进行分发播放。
CDN 域名/CDN 播放域名：LVB CDN 中的播放域名，用于直播流分发。
1. 开通 LVB 服务
在进行腾讯云 CDN 配置前，请先确保您已经 开通腾讯云直播服务。
2. 授权 StreamPackage 访问 LVB
回到 StreamPackage 控制台，打开您需要配置 CDN 分发的 Channel 详情页，选择 CDN 选项，点击下方 Authorization 开始授权 StreamPackage 访问 LVB服务流程。
说明
完成 StreamPackage 访问 LVB 的授权后，StreamPackage 可为 Channel 创建一个直播播放域名。
﻿
点击 Click here 授权 StreamPackage 使用 LVB CDN。若要使用 StreamPackage 功能，需允许 StreamPackage 访问您的部分资源，他们将通过服务角色访问这些授权资源，以实现当前的功能。点击 Authorization Now 跳转至角色管理，单击 Grant 将访问相关服务 API 的权限授予StreamPackage。
﻿
﻿
﻿
﻿
﻿
﻿
自动跳转回 StreamPackage 控制台，点击 Authorize completed，提示已授权 StreamPackage 使用 LVB CDN。
﻿
﻿
﻿
﻿
﻿
﻿
点击 Next 进入下一步。
3. 授权 LVB 访问 StreamPackage
单击 Click here 转到 CDN 控制台，并授权 LVB CDN 使用 StreamPackage。LVB 控制台授权状态已变为 Activated。
﻿
﻿
﻿
﻿
﻿
﻿
回到 StreamPackage 控制台界面，点击 Completed。
﻿
﻿
﻿
此时显示已授权 LVB CDN 使用 StreamPackage。点击下方 Authorization Completed，至此，您已经完成了 StreamPackage 与 LVB 的双向授权（即可通过StreamPackage 的 Channel 快速创建一个 CDN 播放域名，LVB 也可以回源到 Channel 进行拉流分发）
﻿
﻿
﻿
4. 快速配置 CDN 播放域名
完成上述双向授权后，打开 CDN 选项栏，点击 Edit Configuration 即可快速进行 CDN 配置。
﻿
﻿
﻿
输入您用于 CDN 播放的域名，点击 Confirm 即配置完成。
﻿
﻿
﻿
﻿
﻿
﻿
说明
新创建的播放域名添加成功后，系统会为您自动分配一个 CNAME 域名（以.liveplay.myqcloud.com为后缀）。CNAME 域名不能直接访问，您需要在域名服务提供商处完成 CNAME 配置，配置生效后才可享受云直播服务。CNAME 相关操作详见：CNAME 配置﻿
在 StreamPackage 配置的 CDN 播放域名的播放区域默认为中国大陆之外的海外区域（含中国香港、中国台湾、中国澳门）。若您需要在中国大陆地区进行直播分发，根据中国大陆的相关法律规定，需要对播放域名进行备案，请点击 Go to LVB CDN console 前往直播控制台做更多操作。
通过配置的播放域名进行播放
StreamPackage 的 Channel 配置绑定 CDN 播放域名后，将 Endpoint 的播放地址中的域名替换为 CDN 播放域名即可正常播放。
例如：
您某个 Channel 的 Endpoint 拉流地址为：
http://123456789.ap-seoul.streampackage.srclivepull.myqcloud.com/v1/017697a3513109df73abda3c4b26/017697a918bf09dfabc033b04d43/main.m3u8
则您的 CDN 播放地址为：
http://CDN播放域名/v1/017697a3513109df73abda3c4b26/017697a918bf09dfabc033b04d43/main.m3u8
配置完成后请联系我们对你的配置进行优化，以确保您的使用体验更佳。
说明
使用直播 CDN 进行分发播放会产生直播流量费用，详见 云直播费用。
四、编辑和删除 Channel
在 Channel 列表页，用户可对创建完成的所有 Channel 进行管理。在操作栏右侧点击 Info/Edit/Delete，可查看 Channel 的详情、重新编辑和删除 Channel 操作。当 Channel 已有 endpoint 节点时不支持删除，若需要删除 Channel 需先删除包含的所有 Endpoint 节点。
﻿
﻿
﻿