更新时间:2022-04-07 GMT+08:00
分享

热词管理

前提条件

确保已按照配置Java环境配置完毕。

初始化Client

初始化HotWordClient,其参数包括AuthInfo和SisConfig。

表1 AuthInfo

参数名称

是否必选

参数类型

描述

ak

String

用户的ak,可参考AK/SK认证

sk

String

用户的sk,可参考AK/SK认证

region

String

区域,如cn-north-4,参考终端节点

projectId

String

项目ID,同region一一对应,参考获取项目ID

endpoint

String

终端节点,参考地区和终端节点

表2 SisConfig

参数名称

是否必选

参数类型

描述

connectionTimeout

Integer

连接超时,默认10000,单位ms。

readTimeout

Integer

读取超时,默认10000,单位ms。

请求参数

请求类为HotWordRequest,详见表3

表3 HotWordRequest

参数名称

是否必选

参数类型

描述

name

String

热词表名,创建时不可重复。内容限制为字母,数字,下中划线和井号,长度不超过32字节。

language

String

热词表语言类型,目前支持汉语普通话“chinese_mandarin”

contents

Array of String

热词库,单词库支持热词数上限1024。单个热词长度上限32字节。

description

String

热词表描述,长度不超过255字节。

响应参数

创建热词响应参数为String,表示热词表ID。调用失败处理方法请参见错误码

代码示例

import com.huawei.sis.bean.AuthInfo;
import com.huawei.sis.bean.SisConfig;
import com.huawei.sis.bean.SisConstant;
import com.huawei.sis.bean.request.HotWordRequest;
import com.huawei.sis.bean.response.HotWordsResponse;
import com.huawei.sis.bean.response.HotWordResponse;
import com.huawei.sis.client.HotWordClient;
import com.huawei.sis.exception.SisException;
import com.huawei.sis.util.JsonUtils;

import java.util.ArrayList;
import java.util.List;

/**
 * 热词demo
 *
 * 热词可在一句话识别、录音文件识别、实时语音识别使用。例如将地名和人名作为热词,则语音可以准确识别出人名和地名。
 * Copyright 2021 Huawei Technologies Co.,Ltd.
 */
public class HotWordDemo {
  private String ak = "";
  private String sk = "";
  private String region = "";    // 区域,如cn-north-1、cn-north-4
  private String projectId = ""; // 项目id。登录管理控制台,鼠标移动到右上角的用户名上,在下拉列表中选择我的凭证,在项目列表中查看项目id。多项目时,展开“所属区域”,从“项目ID”列获取子项目ID。

  private String name = "test";      // 创建热词表时,需要确保热词表名之前未创建过。如 test1
  private String vocabularyId = "";  // 热词表id,仅在更新、查询,删除中使用,创建时不需要。使用前一定要确保热词表id已存在。
  private List<String> hotWordList = new ArrayList<>(); // 用于存放热词表,每个热词表最多存放1024个热词。如["计算机", "网络"]

  /**
   * 定义config,所有参数可选,设置超时时间等。
   *
   * @return SisConfig
   */
  private SisConfig getConfig() {
    SisConfig config = new SisConfig();
    // 设置连接超时,默认10000ms
    config.setConnectionTimeout(SisConstant.DEFAULT_CONNECTION_TIMEOUT);
    // 设置读取超时,默认10000ms
    config.setReadTimeout(SisConstant.DEFAULT_READ_TIMEOUT);
    // 设置代理, 一定要确保代理可用才启动此设置。 代理初始化也可用不加密的代理,new ProxyHostInfo(host, port);
    // ProxyHostInfo proxy = new ProxyHostInfo(host, port, username, password);
    // config.setProxy(proxy);
    return config;
  }

  /**
   * 1. 热词使用包含创建、更新、查询、删除等,一个用户可以创建多个热词表,一个热词表可以包含多个热词。一个vocabularyId对应一个热词表。
   * 2. 目前支持一个用户最多创建10个热词表,一个热词表最多包含1024个热词。
   */
  private void hotWordDemo() {
    try {
      // 初始化client
      AuthInfo authInfo = new AuthInfo(ak, sk, region, projectId);
      SisConfig config = getConfig();
      HotWordClient hotWordClient = new HotWordClient(authInfo, config);

      // option 1 创建热词表,可生成热词表id
      // name表示热词表表名,创建热词表时不可和已有表名重复
      // hotWordList表示热词表信息,用于存放热词
      hotWordList.add("测试");
      HotWordRequest hotWordRequest = new HotWordRequest(name, hotWordList);
      // 可选,热词表描述信息
      hotWordRequest.setDescription("test");
      // 可选,热词语言,目前仅支持中文 chinese_mandarin。
      hotWordRequest.setLanguage("chinese_mandarin");
      vocabularyId = hotWordClient.create(hotWordRequest);
      System.out.println("成功创建热词表,热词表id为" + vocabularyId);

      // option 2 根据热词表id 更新热词表。新的热词表会替换旧的热词表。使用前需确保热词表id已存在。
      hotWordList.add("华为");
      HotWordRequest updateRequest = new HotWordRequest(name, hotWordList);
      String updateVocabularyId = hotWordClient.update(updateRequest, vocabularyId);
      System.out.println("成功更新热词表,热词表id为" + updateVocabularyId);

      // option 3 查看热词表列表
      HotWordsResponse hotWordListResponse = hotWordClient.query();
      // 打印响应,可通过getXX方法获取具体参数
      System.out.println(JsonUtils.obj2Str(hotWordListResponse, true));

      // option 4 根据热词表id 查询热词表,使用前需确保热词表id已存在。。
      HotWordResponse hotWordResponse = hotWordClient.query(vocabularyId);
      // 打印响应,可通过getXX方法获取具体参数
      System.out.println(JsonUtils.obj2Str(hotWordResponse, true));

      // option 5 根据vocabularyId 删除热词表,使用前需确保热词表id已存在。
      // 删除无返回结果,无报错异常即表明删除成功。
      hotWordClient.delete(vocabularyId);
    } catch (SisException e) {
      e.printStackTrace();
      System.out.println("error_code:" + e.getErrorCode() + "\terror_msg:" + e.getErrorMsg());
    }

  }

  public static void main(String[] args) {
    HotWordDemo hotWordDemo = new HotWordDemo();
    hotWordDemo.hotWordDemo();
  }
}
分享:

    相关文档

    相关产品

关闭导读