通过

基于编码方案的迁移指南

  • 项目

migration guide logo

migration steps 2

本文提供了基于编码方案的指南，可帮助你从 Azure 媒体服务 v2 迁移到 v3。

先决条件

在开始更改编码工作流之前，应了解存储管理方式的区别。 在 AMS V3 中，Azure 存储 API 用于管理与媒体服务帐户关联的存储帐户。

注意

在 v2 中创建作业和任务不会在 v3 中显示，因为它们不与转换相关联。 建议切换到 v3 转换和作业。

编码工作流比较

请花几分钟时间查看下面的流程图，以直观地比较 V2 和 V3 的编码工作流。

V2 编码工作流

单击下面的图像查看大图。

Encoding workflow for V2

  1. 设置
    1. 创建资产或使用现有资产。 如果使用新资产，请将内容上传到该资产。 如果使用现有资源，则应该对资产中已存在的文件进行编码。
    2. 获取以下项的值：
      • 媒体处理器 ID 或对象
      • 要使用的编码器的编码器字符串（名称）
      • 新资产的资产 ID 或现有资产的资产 ID
    3. 对于监视，请创建作业或任务级别的通知订阅或 SDK 事件处理程序
  2. 创建包含任务的作业。 每项任务应包括上述各项和：
    • 需要创建输出资产的指令。 输出资产由系统创建。
    • 输出资产的可选名称
  3. 提交作业。
  4. 监视作业。

V3 编码工作流

Encoding workflow for V3

  1. 设置
    1. 创建资产或使用现有资产。 如果使用新资产，请将内容上传到该资产。 如果使用现有资源，则应该对资产中已存在的文件进行编码。 不应将更多内容上传到该资产。
    2. 创建输出资产。 输出资产是编码文件以及输入和输出元数据的存储位置。
    3. 获取转换的值：
      • 标准编码器预设
      • AMS 资源组
      • AMS 帐户名称
    4. 创建转换或使用现有转换。 转换是可重用的。 每次要提交作业时，都不必创建新的转换。
  2. 创建作业
    1. 为作业获取以下各项的值：
      • 转换名称
      • 资产的 SAS URL、文件共享的 HTTPs 源路径或文件的本地路径的基本 URI。 JobInputAsset 还可以使用资产名称作为输入。
      • 文件名
      • 输出资产
      • 资源组
      • AMS 帐户名称
  3. 使用事件网格来监视作业。
  4. 提交作业。

从 V2 到 V3 编码的自定义预设

如果你的 V2 代码使用自定义预设调用了标准编码器，则在提交作业之前，首先需要使用自定义标准编码器预设创建新的转换。

自定义预设现在为 JSON，不再基于 XML。 按照转换 Open API (Swagger) 文档中定义的自定义预设架构，在 JSON 中重新创建预设。

编码作业中的输入和输出元数据文件

在 v2 中，XML 输入和输出元数据文件将作为编码作业的结果生成。 在 v3 中，元数据格式已从 XML 更改为 JSON。 有关元数据的详细信息，请参阅输入元数据和输出元数据。

具有 HTTPS 托管 URL 上的输入的作业

现在，可以使用 HTTP 作业输入支持从存储在 Azure 存储、本地存储或外部 Web 服务器中的文件提交 V3 中的作业。

如果以前在提交作业之前使用工作流将文件从 Azure blob 文件复制到空资产中，则可以通过将 Azure blob 存储中的文件的 SAS URL 直接传递到作业中来简化工作流。

索引器 v1 音频听录到新 AudioAnalyzer“基本模式”

对于在 v2 API 中使用索引器 v1 处理器的客户，你需要创建一个转换，以在提交作业之前以基本模式调用新的 AudioAnalyzer。

编码、转换和作业概念、教程以及操作方法指南