快速开始#

重要提示

请参阅许可条款和云协议

以下步骤将帮助您在 Linux 系统上设置和运行微服务，并使用我们的简单示例应用程序实时接收 blendshape。

对于 Windows，我们建议按照 WSL 设置指南 使用 WSL。设置 WSL 后，您可以按照文档的 Audio2Face-3D Authoring 部分中的任何页面进行操作，但请确保在 WSL 终端内运行命令。

先决条件#

本文档假定以下系统要求

操作系统

Ubuntu 22.04

CUDA

12.6

驱动程序

535.183.06（用于数据中心 GPU），560.35.03（用于 RTX GPU）

Docker

最新版本

  • 任何 Linux 发行版都应该可以工作，但我们的团队尚未对其进行测试。

  • 对于 Linux 的 Windows 子系统 (WSL)，预计可以在 560.94 驱动程序上工作。

  • 一些较新版本的 CUDA 12.x 尚未经过全面测试，并且在 TRT 模型生成期间可能会遇到问题。

  • 示例应用程序将在 python Docker 容器内运行。

NGC ACE EA 访问权限#

要下载 Audio2Face-3D Authoring Container，您需要访问 NGC nvidia/ace。您可以通过填写 ACE EA 申请表 来请求访问权限。

注意

抢先体验 (EA) 产品仅适用于部分客户。

NGC 访问权限和云函数运行密钥#

您将需要一个 NGC 帐户才能访问 NGC 资源并自行托管 A2F-3D Authoring 微服务。还需要单独的云函数运行密钥才能使用该服务。如果您没有 NGC 访问权限或 NVIDIA 客户经理未为您分配云函数运行密钥，请联系您的 NVIDIA 客户经理。

设置示例应用程序#

您可以通过克隆此存储库来下载示例应用程序：NVIDIA/Audio2Face-3D-Samples 然后转到 early_access/a2f-3d-authoring-sample-app 子文件夹。

$ git clone https://github.com/NVIDIA/Audio2Face-3D-Samples.git
$ cd Audio2Face-3D-Samples/early_access/a2f-3d-authoring-sample-app

在其中，您将找到 client_nvcf_deploy.py 脚本。按照 README.md 文件中 Requirements 部分的说明，在 python 环境中设置 python 依赖项。

尝试 Audio2Face-3D Authoring 微服务#

使用您分配的 Cloud Function Run Key、function-id 和 version-id，您可以与 A2F-3D Authoring MS 的 NVCF 部署进行通信。请注意，此处使用的 API_Key 应该是您分配的云函数运行密钥，而不是您的 NGC API 密钥。在前一步骤的 Docker 容器中，您可以运行

$ python3 client_nvcf_deploy.py data_capture --function-id {FUNCTION_ID} --version-id {VERSION_ID} --apikey {API_KEY} --audio-clip ../../example_audio/Claire_neutral.wav

您可以在此表中找到正确的 ID

模型

函数 ID

版本 ID

Mark

5d8b0f5f-6d3c-4987-b066-5c0be0fdda00

6b2e47e4-98b9-485b-8b31-20977683613d

Claire

4dd6b29e-f4bd-45a8-8b14-c420f8b83f5b

235462c6-8d92-4e7d-9ac8-c550b3459bee

James

cc615922-ec78-4cdf-9b72-388ddf1935c4

812c80db-2e62-4e8e-955b-b1de4801febd

注意

此微服务托管在美国。因此，对于偏远地区，建议 自行部署容器。

脚本的结果保存在 2 个文件中

  • output_blendshape.csv：包含 blendshape 及其名称、值和时间码。

  • output_emotions.csv：包含 emotion 及其名称、值和时间码。

时间码相对于音频文件的开头。

对于其他功能，例如检查服务运行状况，您可以按照 NVCF 版本的 示例应用程序 的完整指南进行操作。

我们推荐以下工作流程

  • （可选）自行部署 Authoring 微服务。

  • 尝试 示例应用程序 以检查您的服务运行状况（如果使用自部署）或 NVCF 端点运行状况。

  • 通过将 Maya-ACE 连接到 Authoring 微服务来尝试交互式 Avatar 调整。请按照 此部分 进行操作。

在本页中