语音交互服务 SIS-一句话识别(http版):初始化Client

时间:2024-10-11 09:55:42

初始化Client

初始化SisClient,详细信息如下。

  1. 配置客户端连接参数。
    • 默认配置
      // 使用默认配置
      HttpConfig config = HttpConfig.getDefaultHttpConfig();
    • 网络代理(可选)
      // 根据需要配置网络代理,网络代理默认的协议为 `http` 协议
      config.withProxyHost("proxy.huaweicloud.com")
          .withProxyPort(8080)
          .withProxyUsername("test")
          .withProxyPassword("test");
    • 超时配置(可选)
      // 默认连接超时时间为60秒,可根据需要调整
      config.withTimeout(60);
    • SSL配置(可选)
      // 根据需要配置是否跳过SSL证书验证
      config.withIgnoreSSLVerification(true);
  2. 配置认证信息。

    配置AK、SK、project_id信息。华为云通过AK识别用户的身份,通过SK对请求数据进行签名验证,用于确保请求的机密性、完整性和请求者身份的正确性。

    • 使用永久AK和SK
      BasicCredentials basicCredentials = new BasicCredentials()
          .withAk(ak)
          .withSk(sk)
          .withProjectId(projectId);
    • 使用临时AK和SK
      BasicCredentials basicCredentials = new BasicCredentials()
          .withAk(ak)
          .withSk(sk)
          .withSecurityToken(securityToken)
          .withProjectId(projectId)

    认证参数说明:

  3. 初始化客户端(region和指定云服务enddpoint二选一即可)。
    • 指定region方式(强烈推荐推荐)
      // 初始化客户端认证信息,使用当前客户端初始化方式可不填 projectId/domainId,以初始化 BasicCredentials 为例
      BasicCredentials basicCredentials = new BasicCredentials()
          .withAk(ak)
          .withSk(sk);
      
      // 初始化指定云服务的客户端 {Service}Client ,以初始化 Region 级服务Sis的 SisClient 为例
      SisClient client = SisClient.newBuilder()
          .withHttpConfig(config)
          .withCredential(bhttps://developer.huaweicloud.com/endpoint?SISasicCredentials)
          .withRegion(SisRegion.valueOf("cn-north-4"))
          .build();
    • 指定云服务endpoint方式(可选)
      // 指定终端节点,以Sis服务北京四的 endpoint 为例
      String endpoint = "https://sis-ext.cn-north-4.myhuaweicloud.com";
      
      // 初始化客户端认证信息,需要填写相应 projectId/domainId,以初始化 BasicCredentials 为例
      BasicCredentials basicCredentials = new BasicCredentials()
          .withAk(ak)
          .withSk(sk)
          .withProjectId(projectId);
      
      // 初始化指定云服务的客户端 {Service}Client ,以初始化 Region 级服务SiS的 SisClient 为例
      SisClient client = SisClient.newBuilder()
          .withHttpConfig(config)
          .withCredential(basicCredentials)
          .withEndpoint(endpoint)
          .build();

      endpoint是华为云各服务应用区域和各服务的终端节点,详情请查看 地区和终端节点

support.huaweicloud.com/sdkreference-sis/sis_05_0085.html