服务端API接入

整体接入流程

针对数字人流媒体服务接入的整体流程如下图示（3D数字人流媒体服务和2D数字人流媒体服务接入流程一致）：

以下以Java开发语言为例介绍虚拟数字人开放平台服务端SDK接入方案，其他语言可参考虚拟数字人开放平台SDK。关于RTC拉流端SDK接入可参考实时流媒体服务接入。

1. API SDK引入

• 针对Java应用在pom.xml中引入如下dependency获得虚拟数字人开放平台Java SDK

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>avatar20220130</artifactId>
  <version>${latest_version}</version>
</dependency>

2. SDK初始化

升级版 SDK 中因为具备完整的参数处理、返回值处理以及请求逻辑，所以可以给不同云产品的 SDK 生成不同的 Client 并包含其产品下所有的 OpenAPI 请求方法，可以使不同云产品之间的身份及鉴权信息隔离，使用上更加安全，下面是产品数字人开放平台 SDK 初始化示例：

public static void main(String[] args) {
    Config config = new com.aliyun.teaopenapi.models.Config();
    config.setAccessKeyId("<accessKeyId>");
    config.setAccessKeySecret("<accessKeySecret>");
    config.setEndpoint("avatar.cn-zhangjiakou.aliyuncs.com");
    Client client = new Client(config);
}

3. 请求OpenAPI

启动数字人流媒体服务

• 启动一路默认数字人流媒体服务（将数字人渲染的视频流推流到阿里云RTC服务器，客户可通过阿里云RTC拉流SDK进行拉流显示）示例：

public static void main(String[] args) {    
    StartInstanceRequest startInstanceRequest = new StartInstanceRequest();
    // 租户ID从数字人开放平台的业务配置详情中获取
    startInstanceRequest.setTenantId(<tenantId>);
    // 业务AppId从数字人开放平台的业务配置详情中获取
    startInstanceRequest.setApp(new StartInstanceRequest.StartInstanceRequestApp().setAppId("<appId>"));
    startInstanceRequest.setUser(new StartInstanceRequest.StartInstanceRequestUser().setUserId("<userId>").setUserName("<userName>"));   
    StartInstanceResponse startInstanceResponse = client.startInstance(startInstanceRequest);

    // 获取启动后SessionId，在后续的文本播报接口中需要传入
    String sessionId = startInstanceResponse.getBody().getData().getSessionId();
}

• 启动一路RTMP推流数字人流媒体服务（将数字人渲染的视频流以RTMP协议推流到指定RTMP服务器，客户可通过对应的RTMP服务器的协议进行拉流显示，更多信息可参考3D推流数字人接入指南）示例：

public static void main(String[] args) {    
    StartInstanceRequest startInstanceRequest = new StartInstanceRequest();
    // 租户ID从数字人开放平台的业务配置详情中获取
    startInstanceRequest.setTenantId(<tenantId>);
    // 业务AppId从数字人开放平台的业务配置详情中获取
    startInstanceRequest.setApp(new StartInstanceRequest.StartInstanceRequestApp().setAppId("<appId>"));
    startInstanceRequest.setUser(new StartInstanceRequest.StartInstanceRequestUser().setUserId("<userId>").setUserName("<userName>"));
    //自定义RTMP
    String chanelType = "RTMP";
    Map<String, String> reqConfig = new HashMap<>();
    reqConfig.put("url", "<RTMP地址>");
    reqConfig.put("token", "<RTMP认证token>");
    startInstanceRequest.setChannel(new StartInstanceRequest.StartInstanceRequestChannel().setType(chanelType).setReqConfig(reqConfig));     
    StartInstanceResponse startInstanceResponse = client.startInstance(startInstanceRequest);

    // 获取启动后SessionId，在后续的文本播报接口中需要传入
    String sessionId = startInstanceResponse.getBody().getData().getSessionId();
}   

数字人播报文本

• 启动数字人流媒体服务之后，播报一段文本。

public static void main(String[] args) {    
    SendMessageRequest sendMessageRequest = new SendMessageRequest();
    // 租户ID从数字人开放平台的业务配置详情中获取
    sendMessageRequest.setTenantId(<tenantId>);
    // 传入SessionId（从StartInstance返回值中获取）
    sendMessageRequest.setSessionId(<sessionId>);
    // 传入要播报的文本内容
    sendMessageRequest.setTextRequest(new SendMessageRequest.SendMessageRequestTextRequest().setCommandType("START").setSpeechText("你好，我是智慧数字人小萌，很高兴跟大家见面")
                .setId(UUID.randomUUID().toString()));
    SendMessageResponse sendMessageResponse = client.sendMessage(sendMessageRequest);
}

结束数字人流媒体服务

• 结束数字人流媒体服务

public static void main(String[] args) {    
    StopInstanceRequest stopInstanceRequest = new StopInstanceRequest();
    // 租户ID从数字人开放平台的业务配置详情中获取
    stopInstanceRequest.setTenantId(<tenantId>);
    // 传入SessionId（从StartInstance返回值中获取）
    stopInstanceRequest.setSessionId(<sessionId>);
    StopInstanceResponse stopInstanceResponse = client.stopInstance(stopInstanceRequest);
}

关于以上API更多的详细使用方法可以进入API参考指南进行查看。