# 从这里开始

DUIX交互产品基于语音识别、语音合成、自然语言理解,AIGC,大模型等技术,实现“能听、会说、懂你”式的智能人机交互体验,适用于智能客服、智慧大屏等多个企业应用场景。本文为您介绍DUIX交互产品功能和功能体验等内容。

# 入门流程

快速入门文档介绍使用DUIX服务需要的步骤,帮助您快速开通服务、创建测试项目和调用DUIX服务。

image.png

# 准备账号

DUIX账号作为DUIX系统识别的资源消费账户,有DUIX产品的管理权限。DUIX官网 (opens new window)使用手机号验证码注册登录即可。

# 创建应用

登录DUIX工作台之后,可以在“资源管理“菜单下的“应用“tab标签里面添加应用。

image.png

# 购买并发

由于默认应用仅用于体验不保证并发,如果正式环境使用建议创建应用并购买并发来保证服务有稳定的并发。

image.png

# 获取appId

登录DUIX工作台之后,可以在“资源管理”菜单下的“应用”tab标签里面获取到appId。 image.png

# 获取conversationId

登录DUIX工作台之后,可以在“会话管理”菜单下的会话卡片上复制会话Id

image.png

# 获取Token

访问令牌(Token)是调用DUIX交互服务的服务鉴权凭证。所有的HTTP调用接口都需要将Token放入Header头中。下面介绍获取访问令牌的方法。

# 前提条件

已获取appKey和appId,可在创建的数字人会话管理中获取。

###操作步骤

1、通过appKey和appId生成签名。

2、使用签名作为调用h5 sdk的init方法的入参

# 签名生成

签名使用的是JWT机制,用户可以参照下述完成签名

# 参数说明

签名生成需要准备以下参数

名称 类型 描述 示例
appId string 会话标识,会话创建成功后获取 xxxxxxx
appKey string 会话密钥,会话创建成功后获取 xxxxxxx
sigExp Integer 签名有效时间,单位秒 1800

# 演示代码

签名的示例代码如下,Java版示例

引入pom依赖

<dependency>
    <groupId>com.auth0</groupId>
    <artifactId>java-jwt</artifactId>
    <version>3.8.3</version>
</dependency>
import com.auth0.jwt.JWT;
import com.auth0.jwt.algorithms.Algorithm;
import java.util.Calendar;
import java.util.Date;

public class SigUtils {
    /**
     * 创建签名
     *
     * @param appId  会话标识
     * @param appKey 会话密钥
     * @param sigExp 签名有效时间:单位秒
     * @return
     */
    public static String createSig(String appId, String appKey, int sigExp) {
        Calendar nowTime = Calendar.getInstance();
        nowTime.add(Calendar.SECOND, sigExp);
        Date expiresDate = nowTime.getTime();
        return JWT.create()
                //发行时间
                .withIssuedAt(new Date())
                //有效时间
                .withExpiresAt(expiresDate)
                //载荷
                .withClaim("appId", appId)
                //加密
                .sign(Algorithm.HMAC256(appKey));
    }
}

** 注意:此签名(Token)即H5 SDK的sign

# 集成开发

根据以上几个步骤获取的AppID,秘钥和Token,就可以通过SDK和API概览详细了解在各类平台如何将DUIX集成到您的服务当中。