本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# live-to-VOD内容交付入门 MediaPackage
<a name="getting-started-ltov"></a>

本入门教程向您展示了如何使用 AWS Elemental MediaPackage 控制台创建 live-to-VOD（视频点播）资源并使其可供播放。

要提供 live-to-VOD内容，您需要做以下三件事：
+ 将 HLS 直播内容流收录到 MediaPackage
+ 从流中提取 VOD 资产
+ 使资产可用于播放 
**注意**  
您无需使用即可将 live-to-VOD资产交付 MediaPackage 给观众。本教程旨在说明如何使用 MediaPackage 来完成工作 live-to-VOD流程。

以下各节是指导教程，使您熟悉这三件事和其他支持操作。

## 先决条件
<a name="gs-prereq-ltov"></a>

在使用之前 AWS Elemental MediaPackage，您需要一个 AWS 帐户和相应的权限才能访问、查看和编辑 MediaPackage 组件。确保系统管理员已完成[设置 MediaPackage](setting-up.md)中的以下步骤，然后返回到本教程。
+ 要创建 AWS 账户，请参阅[报名参加 AWS](setting-up-aws-sign-up.md)。
+ 要允许非管理角色访问 MediaPackage，请参阅[创建策略和非管理角色](setting-up-create-non-admin-iam.md)。
+  MediaPackage 要允许访问您的 Amazon S3 存储桶以保存和检索 live-to-VOD资产，请参阅[AWS Elemental MediaPackage 允许访问其他 AWS 服务](setting-up-create-trust-rel.md)。

## 步骤 1：访问 MediaPackage
<a name="gs-access-emp-ltov"></a>

 使用您的 IAM 凭证登录 AWS Elemental MediaPackage 控制台：

```
https://console.aws.amazon.com/mediapackage/
```

## 步骤 2：摄取实时内容
<a name="gs-ingest-live"></a>

要将直播内容流摄入直播内容流 AWS Elemental MediaPackage 并从中提取视频点播 (VOD) 资产，请创建频道和端点。频道是该频道的入口点 MediaPackage，端点提供对直播的 MediaPackage 访问权限，以便它可以提取 VOD 资产。以下各节描述如何使用 MediaPackage 控制台创建通道和终端节点。

### 创建通道
<a name="gs-create-channel-ltov"></a>

该频道是其中的第一个组件 MediaPackage。它表示来自编码 MediaPackage 器的传入直播内容的输入，例如 AWS Elemental MediaLive。

MediaPackage 不要求您提供任何客户数据。当需要您提供客户数据时，通道中没有字段。

**创建通道**

1. 在 MediaPackage **频道**页面上，选择**创建频道**。

1. 对于 **ID**，请输入描述通道的名称，例如 **channelHLS1**。ID 是通道的主要标识符，并且对于 AWS 区域中的账户必须是唯一 ID。支持的字符包括字母、数字、下划线（\$1）和短划线（-）。您不能在 ID 中使用空格。

1. 保留其余字段的默认值，然后选择**创建**。

   MediaPackage 显示新频道的详细信息页面。

1. 在通道的详细信息页面上，记下 **URL**、**用户名**和**密码**的值。如果您使用的是输入冗余，则两个输入都需要此信息 URLs。如果您只向通道发送一个流，则可以记下任一输入 URL 的信息。

   MediaPackage WebDAV 在创建频道时会安全地生成 WebDAV 用户名和密码。如果需要更改这些凭证，请参阅[在输入 URL 上轮换凭证](channels-rotate-creds.md)。

   从这些字段向负责上游编码器的人提供信息。在编码器的流配置中，此人必须键入输入 URL 以作为目标，并将通道的用户名和密码作为 WebDAV 凭证。上游编码器必须使用摘要身份验证，并通过 HTTPS 将 WebDAV 推送 MediaPackage到并包含这些凭据。如果您使用的是输入冗余，则此通道的输入流必须具有相同的编码器设置。有关为输入冗余设置源流的详细信息，请参阅[实时输入冗余 AWS Elemental MediaPackage 处理流程](what-is-flow-ir.md)。

### 创建端点
<a name="gs-create-endpoint-ltov"></a>

终端节点附加到通道，且表示实时内容的输出。当您创建采集作业以从实时内容中提取 VOD 资产时，必须指出要从中进行提取的终端节点。您可以从明文（未加密）或加密的 HLS 和 DASH 端点采集资产，并且端点必须定义一个启动窗口。如果您只有加密的终端节点，请参阅 [使用创建 live-to-VOD资产 AWS Elemental MediaPackage](ltov.md) 功能参考。

MediaPackage 不要求您提供任何客户数据。在需要您提供客户数据的终端节点中没有字段。

**创建端点**

1. 在**通道页面**上，选择将与终端节点关联的通道。

1. 在通道详细信息页面上的**源端点**下，选择**管理端点**。

1. 对于 **ID**，请输入描述终端节点的名称，例如 **HLSendpoint1**。ID 是端点的主要标识符，并且对于 AWS 区域中的账户必须是唯一 ID。支持的字符包括字母、数字、下划线（\$1）和短划线（-）。您不能在 ID 中使用空格。

1. 保留其余字段的默认值，然后选择 **Save (保存)**。

   MediaPackage 显示频道的详细信息页面，包括您刚刚创建的端点。

1. 在通道的详细信息页面上，记下端点的 **URL** 字段中的值。将此信息提供给负责下游设备 (CDN 或播放器) 的人。在下游设备中，此人必须输入终端节点的 URL 以作为请求目标。

## 步骤 3：提取 VOD 资产
<a name="gs-create-hj-ltov"></a>

要从直播内容流中提取 live-to-VOD资产，请创建采集作业。收获任务可以识别资产的收获端点、资产的起点和终点，以及收获后在哪里 MediaPackage 保存资产。

**创建采集作业**

1. 在**采集作业**页面上，选择**创建采集作业**。

1. 对于 **ID**，请输入描述采集作业的名称，例如 **gamehighlights**。该 ID 是作业的主要标识符。您可以在账户中的收获作业过期后重新使用此 ID。支持的字符包括字母、数字、下划线（\$1）和短划线（-）。您不能在 ID 中使用空格。

1. 对于 **Origin endpoint (原始终端节点)**，选择要从中提取 VOD 资产的实时内容流的终端节点。端点必须提供明文（未加密）的 DASH 或 HLS 内容。如果要从加密的实时内容中提取，请参阅 [使用创建 live-to-VOD资产 AWS Elemental MediaPackage](ltov.md)。

1. 对于 **Date and time format (日期和时间格式)**，请保留默认值。

1. **在 live-to-VOD资源开始**时间和资源**结束时间中 live-to-VOD**，输入提取的 VOD 资产的开始和结束日期和时间。我们建议开始时间在实时流开始之后和当前时间（“现在”）之前。结束时间必须是过去的时间。
**注意**  
“现在”是根据 `EXT-X-PROGRAM-DATE-TIME` 的当前时间（当其出现在编码器的源内容中时）。因此，我们建议上游编码器在源中提供一个 `EXT-X-PROGRAM-DATE-TIME` 标签。

1. 对于 **IAM 角色 ARN**，请输入允许 MediaPackage 将您的 live-to-VOD资产写入您的 Amazon S3 存储桶的 IAM 角色。有关角色的帮助，请参阅[AWS Elemental MediaPackage 允许访问其他 AWS 服务](setting-up-create-trust-rel.md)。

1. 在 A **mazon S3 存储桶名称**中，选择 MediaPackage 要存储 live-to-VOD资产的 Amazon S3 存储桶。

1. 对于**清单密钥**，输入 Amazon S3 存储桶中的路径和 live-to-VOD资产父清单的标识符。 MediaPackage 根据您输入的路径创建目录。
**重要**  
清单密钥必须是唯一的。当您对多个采集作业使用相同的清单键时，资产的最新播放列表将覆盖现有播放列表。唯一应重复使用清单密钥的时间是在采集相同内容时，例如，如果先前内容的采集存在问题。

1. 选择**创建**。

 MediaPackage 处理收获任务时，它会在作业失败或成功时发送一个 CloudWatch 事件。事件中将包括采集作业的详细信息。如果作业失败，则事件将包括原因相关信息。此信息仅在 CloudWatch 活动中可用。有关示例事件，请参阅 [采集作业通知事件](cloudwatch-events-example.md#hj-status-events)。

## （可选）步骤 4：输出 VOD 内容
<a name="gs-output-vod"></a>

 MediaPackage 要使用使资源可供播放，请创建打包组、打包配置和资产资源。 live-to-VOD该 live-to-VOD资产从 Amazon S3 存储桶中提取资产。一个打包组包含一个或多个打包配置，这些配置定义输出格式和设置。

### 创建打包组
<a name="gs-create-grp-ltov"></a>

打包组包含一个或多个打包配置。通过打包配置，您可以定义所需的 VOD 输出类型。要应用这些输出定义，请将打包组关联到多个资产。

**Example**  
 如果您有 15 个源内容。您希望把这些源内容全部作为 DASH、HLS 和加密 HLS 输出提供。为此，您定义了一个包含 DASH、HLS 和加密 HLS 打包配置的打包组。然后，将该组关联到代表这些内容的资产资源。您不必为每个资产创建新的配置。

MediaPackage 不要求您提供任何客户数据。打包组中没有任何字段需要您提供客户数据。

**创建打包组**

1. 在**打包组**页面上，选择**创建组**。

1. 对于 **ID**，输入描述组的名称，例如 **gamehighlights**。ID 是组的主要标识符，并且对于此 AWS 区域中的账户必须是唯一 ID。支持的字符包括字母、数字、下划线（\$1）和短划线（-）。您不能在 ID 中使用空格。

1. 选择**创建**。

### 创建打包配置
<a name="gs-create-cfig-ltov"></a>

打包配置指定如何配置输出清单，例如流选择限制和排序。

MediaPackage 不要求您提供任何客户数据。打包配置中没有任何字段需要您提供客户数据。

**创建打包配置**

1. 在 **Packaging groups (打包组)** 页面上，选择刚创建的组。

1. 在打包组详细信息页面的**打包配置**下，选择**管理配置**。

1. 在**管理打包配置**页面上，选择**添加**，然后选择**新配置**。

1. 对于 **ID**，请输入描述配置的名称，例如 **hls\$1highlights**。ID 是配置的主要标识符，并且对于此 AWS 区域中的账户必须是唯一 ID。支持的字符包括字母、数字、下划线（\$1）和短划线（-）。您不能在 ID 中使用空格。

1. 保留其余字段的默认值，然后选择 **Save (保存)**。

### 创建资产
<a name="gs-create-asset-ltov"></a>

资产资源是提取、 AWS Elemental MediaPackage 打包和提供 VOD 内容的方式。资产与一个或多个打包配置相关联。下游设备向资产上的特定打包配置发送播放请求。

MediaPackage 不需要您提供客户数据，因此资产不包含这些字段。

**创建资产并提取源内容**

1. 从 Amazon S3 存储桶中，确定您用作源内容的文件。记下以下内容：
   + 存储文件的 Amazon S3 存储桶名称
   + 文件的完整路径，例如 *S3://bucket/path/source-file-nam* e
   + 允许从 Amazon S3 读 MediaPackage 取数据的 IAM 角色

1. 在 MediaPackage 控制台上，转到**资产**页面，然后选择**收录资产**。

1. 对于 **Amazon S3 存储桶名称**，选择存储源内容的存储桶。

1. 对于 **IAM 角色**，选择**使用现有角色**并选择允许从 Amazon S3 读 MediaPackage 取的 IAM 角色。

1. 在 “**文件名**” 中，输入 Amazon S3 存储桶中 [.smil 清单](supported-inputs-vod-smil.md) (MP4) 或.m3u8 父播放列表 (HLS) 的完整路径，包括源内容的名称。例如，如果您的内容名为 `lion_movie.m3u8`，并且位于名为 `thursday_night` 的子目录中（该目录在名为 `movies` 的存储桶中），则您需要在**文件名**字段中输入以下内容：

   ```
   thursday_night/lion_movie.m3u8
   ```

   您无需输入存储桶名称，因为您已在 **Amazon S3 存储桶名称**字段中选择名称。

1. 对于**打包组**，选择您在 [创建打包组](#gs-create-grp-ltov) 中创建的组。

1. 选择 **Ingest assets (提取资产)**。

### 提供播放 URLs
<a name="gs-provide-url-ltov"></a>

创建资产资源后， AWS Elemental MediaPackage 准备向查看者提供打包清单。该操作是在后台执行的，可能需要一些时间，具体取决于源内容大小和复杂性，但通常不到几分钟的时间。清单 URLs 中的清单可立即在资产的详细信息页面上找到，但内容尚未可供播放。

每份清单的处理完成后， MediaPackage 向您的账户发送一个 Amazon CloudWatch 事件。

在资产上， MediaPackage 为每个打包配置提供一个 URL。下游设备（CDN 或播放设备）通过该 URL 从 MediaPackage 中请求 VOD 内容。

**要获得播放 URLs**

1. 在 MediaPackage 控制台上，转到**资产**页面，然后选择您在中创建的资产的 **ID** [步骤 4：创建资产](getting-started-vod.md#gs-create-asset)。

1. 在资产的详细信息页面上，获取每个打包配置的 URL。

1.  URLs 向下游设备（CDN 或播放器）的负责人提供。在下游设备中，此人必须输入相应打包配置中的 URL 以作为请求目标。

每个 URL 是非常稳定的。在该资产和打包配置组合的生命周期内，它永远不会发生变化。向负责下游设备（CDN 或播放器）的人员提供该 URL。在下游设备中，此人必须将资产的 URL 作为请求目标。

## （可选）步骤 5：监控 MediaPackage 活动
<a name="gs-monitor-emp-ltov"></a>

使用 Amazon CloudWatch 跟踪 MediaPackage 活动，例如 MediaPackage 已接收和发送的字节数、响应时间和请求计数。指标的分组首先依据服务命名空间，然后依据每个命名空间内的各种维度组合。

**使用 CloudWatch 控制台查看指标**

1. 打开 CloudWatch 控制台，网址为[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)。

1. 在导航窗格中，选择**指标**。

1. 在**所有指标**下，选择 **AWS/ MediaPackage** 命名空间。

1. 选择指标维度以查看指标 (例如，选择 `channel` 以查看每个通道的指标)。

有关 MediaPackage 指标列表，请参阅[AWS Elemental MediaPackage 使用 Amazon CloudWatch 指标进行监控](monitoring-cloudwatch.md)。

## 步骤 6：清除
<a name="gs-cleanup-ltov"></a>

要避免产生额外费用，请删除您不再使用的资源。

**注意**  
采集作业会自动从您的账户中过期，而无法手动删除。

### 删除实时资源
<a name="gs-cleanup-ltov-l"></a>

完成从直播内容的摄取、提供和采集后，请删除通道和终端节点。您必须先删除通道中的所有终端节点，然后才能删除通道。

**删除端点**

1. 在 MediaPackage **频道**页面上，选择与端点关联的频道。

1. 在通道详细信息页面上的**源端点**下，选择您要删除的源端点。

1. 选择**删除**。

1. 在**删除端点**确认对话框中，选择**删除**。

**删除通道**

1. 在**通道**页面上，选择要删除的通道。

1. 选择**删除**。

1. 在**通道删除**确认对话框中，选择**删除**。

   MediaPackage 移除频道和所有关联的端点。

### 删除 VOD 资源
<a name="gs-cleanup-ltov-v"></a>

完成摄取和提供 VOD 内容后，请删除多余的资源。如果要使特定的输出不可用，请从打包组中删除打包配置。如果要使资产无法再从任何输出中播放，请删除该资产。

**删除资产**

1. 在 MediaPackage 控制台上，转到**资产**页面，然后选择资产的 **ID**。

1. 在资产的详细信息页面上，选择 **Delete (删除)**。

1. 在确认对话框中，选择**删除**。

**删除打包配置**

1. 在 MediaPackage 控制台上，转到**打包组**页面。

1. 选择具有要删除的配置的组的 **ID**。

1. 在打包组详细信息页面上的 **Packaging configurations (打包配置)** 部分中，找到该配置并选择其 **ID**。

1. 在打包配置的详细信息页面上，选择 **Delete (删除)**。

1. 在确认对话框中，选择**删除**。