示例1：创建视觉驱动

前提条件

• 已获取需要使用MetaStudio服务的终端节点。
• 已获取需要创建视觉驱动所在区域的项目ID，具体获取方法请参见获取项目ID。

总体流程

1. 获取用户Token
2. 启动数字人视觉驱动
3. 采集视频驱动数字人
4. 停止数字人视觉驱动

操作步骤

1. 获取用户Token，用于调用MetaStudio接口时进行认证鉴权。

   在“我的凭证”页面获取username、password、domainname，调用如下接口获取Token。详细信息请参见构造请求。

   POST https://iam.myhuaweicloud.com/v3/auth/tokens  
   Content-Type: application/json  
   {  
     "auth": {  
       "identity": {  
         "methods": [  
           "password"  
         ],  
         "password": {  
           "user": {  
             "name": "username", //用户名。  
             "password": "password", //用户登录密码。  
             "domain": {  
               "name": "domainname" //用户所属的账号名。    
             }  
           }  
         }  
       },  
       "scope": {  
         "project": {  
            "name": "cn-east-3"  //用户所属region，如cn-east-3。  
         }  
       }  
     }  
   }

   如图1所示，红框中的信息为获取用户Token。

   图1 获取用户Token
   

2. 调用启动视觉驱动接口，获取视觉驱动任务。
   1. 选择POST请求方法并输入URI。

      https://metastudio.cn-east-3.myhuaweicloud.com/v1/{project_id}/video-motion-capture-jobs

   2. 请求消息头中增加“X-Auth-Token”，值设置为步骤1中获取的用户Token。
   3. Request Body中传入驱动模式和驱动数据输出地址及会话ID，如下：

      {
      "motion_capture_mode": "AUTO",
      "output_info": {
      "body_addr": "100.85.133.90:30001",
      "face_addr": "100.85.133.90:30002",
      "session_id": 3223
      }
      }

   4. 请求响应成功后，返回JobID和视频传输使用的RTC房间信息。

      {
      "job_id": "e9def8d3262d434eb9c8f07631c265f6",
      "rtc_room_info": {
      "app_id": "cbu_hmac",
      "room_id": "e9def8d3262d434eb9c8f07631c265f6",
      "users": [{
      "ctime": 1670402765,
      "signature": "d6ab5885978cb2a5f0ee4454eb0bcacdb67eb9eba306ff3072bab1b8d62bf2dd",
      "user_id": "e9def8d3262d434eb9c8f07631c265f6_capture",
      "user_type": "CAPTURE"
      }
      ]
      }
      }

3. 采集视频驱动数字人。

   您可以使用SparkRTC SDK或者自行构造符合SparkRTC协议端侧工具基于上述任务返回的房间信息，使用CAPTURE类型用户信息加入房间，采集视频驱动数字人。驱动数据会通过QUIC发送至配置的目标地址。

4. 调用停止视觉驱动接口，停止视觉驱动任务。
   1. 选择POST请求方法并输入URI，其中job_id为创建任务时返回的job_id。

      https://metastudio.cn-east-3.myhuaweicloud.com/v1/{project_id}/video-motion-capture-jobs/{job_id}/finish

   2. 请求消息头中增加“X-Auth-Token”，值设置为步骤1中获取的用户Token。
   3. Request Body中无需其他参数。
   4. 请求响应成功后，停止视觉驱动任务。