准备 AMS 停用：VI 迁移和更新指南

  • 项目

Azure AI 视频索引器（VI）用于对媒体资产进行编码、打包和流式传输Azure 媒体服务（AMS）。 AMS 宣布将于 2024 年 6 月 30 日退休。 因此，VI 正在删除对 AMS 的依赖项。

若要继续使用 VI，请在 2024 年 2 月 15 日至 6 月 30 日期间执行以下步骤，以便从其当前的 VI 帐户 AMS 依赖项中转换：

  1. 更新 VI 帐户，使其链接到 Azure 存储 帐户而不是 AMS 帐户。
  2. 将现有的 VI AMS 资产从 AMS 托管存储帐户迁移到链接到 VI 帐户的存储帐户。 尽管未迁移资产是可选的，但一旦 AMS 停用，将无法访问以前编制索引的视频或其见解。

这些更改会影响 VI 的许多领域，以及必须采取的准备工作取决于你如何使用它。 因此，在执行 VI 帐户更新之前，应查看你如何使用 VI 并做出所需的更改，使使用 VI 的应用程序和平台免受不利影响。

本文档讨论了其中每个更改、其影响以及需要执行哪些操作才能顺利导航这些更改。

更改

以下说明概述了更新帐户后应用的 VI 产品的更改。 请考虑这些更改以及它们如何影响工作流和代码。 它们仅在更新帐户后应用。

视频上传

AMS 资产 ID 将不再用于上传视频。 将改用视频 URL 或本地文件。

帐户创建、更新和管理

  • 帐户更新：必须在 2 月 15 日之前创建的所有 VI 帐户更新，以便将其链接到Azure 存储帐户而不是 AMS 帐户。 有关如何在门户中或通过 API 执行此操作的指导，请参阅 更新现有 ARM 帐户。
  • 经典帐户 - 连接到新的 ARM 帐户：如 2023 年 9 月宣布的那样，VI 经典帐户将于 2024 年 6 月 30 日停用。 停用之前，所有经典帐户都必须连接到基于 ARM 的新 VI 帐户。 有关如何在门户中或通过 API 执行此操作的指导，请参阅将经典帐户连接到基于 ARM 的新帐户。
  • 使用 API 创建帐户
    • 必须更新帐户创建和使用 VI API 版本 2024-01-01 的请求。
    • 必须使用 Azure 存储 Account 属性而不是 AMS 帐户提交请求。
  • 门户：在 VI 帐户创建过程中，新的 VI 帐户将与Azure 存储帐户相关联。

存储帐户

将Azure 存储帐户链接到 VI 帐户是永久性的，无法撤消。 因此，建议创建一个仅用于 VI 帐户的存储帐户。 （如果希望使用网络限制，这一点尤其重要。建议存储帐户与 VI 帐户位于同一区域。

无法将 VI 帐户链接到以前与 AMS 帐户关联的存储帐户。

经典帐户 - 基于 API 令牌的身份验证

由于 VI 经典帐户将于 2024 年 6 月 30 日停用，具有经典 VI 帐户的所有客户都需要在 2024 年 7 月 1 日之前将其连接到基于 Azure 资源管理器 （ARM） 的 VI 帐户。 通过此更改，生成 VI 访问令牌的方式将发生更改。 虽然 VI 经典帐户使用经典获取访问令牌 API 生成访问令牌进行身份验证，但更新的 VI 帐户基于 ARM，基于 ARM 的帐户使用 ARM API 生成访问令牌。

将经典帐户连接到 ARM、帐户后，有一个 30 天的转换状态期间 ，VI 支持使用经典 API 和 ARM API 生成的访问令牌访问计数。 在此处了解如何将经典帐户连接到 ARM 帐户。

流式处理播放器

截至 2024 年 6 月 30 日，Azure 媒体播放器也将停用。 如果一直在使用 VI 流式处理终结点流式传输视频，则必须选择支持 Dash 或 HLS 打包的其他播放器，并在请求中使用令牌。

流式处理和流式处理终结点

自适应比特率流式处理 – 不再支持使用自适应比特率进行编码和流式处理，如果流式处理设置为自适应比特率，索引请求将失败。 而是提交使用单比特率或无流式处理进行编码的请求。

新编制索引的视频 - 流式处理 URL 的所有 API 请求都将获得 VI 终结点的 URL，而不是 AMS 终结点。 VI 终结点将前缀为“vi-apim”。

以前编制索引的视频 - 更新后的 VI 帐户仍能够流式传输 AMS 资产，直到迁移它们。 在这种情况下，对流 URL 请求的响应会有所不同， Get Streaming Video URLGet Video Index具体取决于资产是否已迁移。 因此，应用程序必须能够同时从 AMS 终结点和 VI 终结点播放。 例如，Shaka 播放器只能播放 VI 终结点，而 AMP 将能够播放 AMS 终结点。

未迁移的视频 - 请求未迁移的视频将返回 AMS 流式处理 URL，直到 2024 年 6 月 30 日。 在该日期之后，你根本无法向 AMS 发出请求。

项目

VI 具有一项项目功能，可用于编辑和拼凑视频。 更新 VI 帐户后，该功能将受到限制，直到视频迁移。 更新的 VI 帐户和 2 月 15 日之后创建的 VI 帐户在 2024 年 6 月之前将无法创建新项目。

现有项目可播放，但无法编辑或呈现它们。 如果需要，请在更新帐户之前呈现和下载项目文件。

如果 VI 正在为你迁移 VI AMS 资产，则会在迁移资产的天数/小时内禁用项目。 迁移完成后，它们将可玩。

你将收到一封电子邮件通知，指出迁移已完成，还可以在 VI 网站上检查迁移状态。

计费

VI 不会收取流式传输费用。 VI 将收取编码的统一费率，在大多数情况下，编码的成本低于以前使用 AMS 进行编码的成本。 编码费用将显示为“视频修改”。如果需要更改任何计费警报，请记得检查。

迁移

由于 2024 年 6 月 30 日 AMS 停用，所有保留 VI 创建的视频和见解的 VI 客户都必须以新格式处理资产，并将其迁移到链接到 VI 帐户的 Azure 存储 帐户。

这需要以下操作：

  • 它将重新处理媒体资产，使用 HLS 和 DASH 清单将 AMS 资产转换为 CMAF 格式。 这是视频索引器和其他播放器流式传输的资产所必需的。
  • 将这些重新处理的资产存储在已链接到 VI 帐户的Azure 存储帐户中。

由于 AMS 资产迁移将很难自行执行，VI 将为文件重新处理和资产移动提供迁移体验。 除了存储已迁移资产以及与移动数据相关的网络成本之外，使用迁移解决方案不产生任何费用。 如果两个存储帐户位于同一区域，成本应较低。 迁移不会立即发生，但 VI 承诺在 AMS 停用日期之前迁移资产。

在 2024 年 6 月 30 日 AMS 停用之前，你可以选择通过 Azure 门户 或通过 API 请求进行更新。

仅迁移与 VI 关联的 AMS 资产。 如果同一存储帐户中存在其他 AMS 资产，则不会迁移它们。

VI 不会删除 AMS 文件的原始副本。 迁移成功完成后，如果链接到 VI 的 AMS 帐户和链接到 AMS 的存储帐户仅用于 VI，则可以考虑删除这两个帐户。

重要

即使在更新帐户后，VI 仍会访问 AMS 帐户及其关联的存储帐户，直到所有视频都已迁移。 在迁移完成之前，请务必不要删除或更改 AMS、Azure 存储或 VI 帐户的帐户、角色或权限。 此外，建议在收到迁移完成的通知之前，不会删除 VI AMS 资产，因为它们可能尚未迁移。 VI 帐户所有者将收到一封电子邮件通知，指出迁移已完成，还可以在 VI 网站上检查迁移状态。

如果资产无法迁移，尽管 VI 多次尝试并重试迁移资产，但迁移将被视为已完成并出现错误，并且会发送未能迁移的文件列表。 还可以从 VI 网站的“迁移”页下载它们。

可以在 VI 网站中查看迁移的状态和进度，帐户所有者在迁移完成后将收到通知电子邮件。

Microsoft 对迁移的任何损害不承担任何责任。

详细的更新和迁移说明

有关完整的分步指南，请参阅 更新 Azure AI 视频索引器帐户并迁移资产。

常见问题解答

我们可以请求 VI 仅迁移某些帐户 VI AMS 资产吗？

不，这一切都或什么都没有。 在开始迁移之前，应查看并删除不希望迁移的任何资产。

我选择了 VI 迁移解决方案，但后来改变了主意。 可以选择退出吗？

无法通过门户或 API 更改请求，并且 VI 可能已经开始迁移资产。 如果需要，可以开具支持票证，如果迁移过程尚未启动，VI 可能能够取消请求。

VI 是否向我收取迁移费用？

不，这是一次免费的体验。 唯一的成本是存储帐户中迁移的资产的存储以及与移动数据相关的网络成本。 如果两个存储帐户位于同一区域，成本应较低。

如果我不使用 VI 进行流式处理或编码，我是否仍必须迁移 VI AMS 资产才能继续访问 VI 见解？

它仍然受到鼓励，因为它将确保你当前可用的任何 VI 数据或资产继续可用。

如果我们不保存任何视频数据，是否需要迁移 VI AMS 资产？

否，除非你想要迁移最初发送到 VI 的源视频进行索引。

我看到我的资产迁移正在进行中 ， 如果某个特定视频尚未迁移，这是否很重要？

在大多数情况下，否。 唯一受影响的方案是使用 VI 流式处理 URL 播放视频。 尚未迁移的视频需要由支持 AMS 资产的播放器（Azure 媒体播放器）播放。 已编制索引的视频需要由支持 Dash 或 HLS 打包的播放器播放，并在请求中发送令牌（如 Shaka、DashJS 或 VideoJS）。

如何判断视频是否已迁移？

通过“获取流式处理 URL”请求的回复 - 如果尚未迁移，它将在开始时包含媒体服务的提及。

是否可以将多个 VI 帐户链接到单个存储帐户？

是

是否可以将多个存储帐户链接到单个 VI 帐户？

否