服务端集成

前提条件

• 您已经了解标准集成接入流程。

• 您已经完成了开通服务、创建应用、配置应用。

• 环境中已安装Java JDK 8的版本。具体操作，请参见安装JDK。

  说明

  若服务端为Linux环境，推荐安装Oracle JDK，不推荐使用Open JDK进行服务端集成。

集成步骤

1. 在配置文件pom.xml中加入下方示例的XML依赖：

   重要

   此处仅以Java语言和SDK V2.8.0版本通过Maven方式集成为例，您可请参见OpenAPI，查看最新版本SDK和更多开发语言版本。

   <dependency>
       <groupId>com.aliyun</groupId>
       <artifactId>tea-openapi</artifactId>
       <version>0.0.19</version>
   </dependency>
   <dependency>
       <groupId>com.aliyun</groupId>
       <artifactId>imp20210630</artifactId>
       <version>2.8.0</version>
   </dependency>

2. 使用Java SDK调用getAuthToken获取长链接建连的Token API为例，验证房间服务是否正常。

import com.alibaba.fastjson.JSON;
import com.aliyun.imp20210630.Client;
import com.aliyun.imp20210630.models.GetAuthTokenRequest;
import com.aliyun.imp20210630.models.GetAuthTokenResponse;
import com.aliyun.teaopenapi.models.Config;
import lombok.extern.slf4j.Slf4j;

@Slf4j
public class Test {

    public static void main(String[] args){

        // API Config
        Config config = new Config();

        // 阿里云账号AccessKey拥有所有API的访问权限，建议您使用RAM用户进行API访问或日常运维。
        // 强烈建议不要把AccessKey ID和AccessKey Secret保存到工程代码里，否则可能导致AccessKey泄露，威胁您账号下所有资源的安全。
        // 本示例通过阿里云Credentials工具从环境变量中读取AccessKey，来实现API访问的身份验证。如何配置环境变量，请参见https://help.aliyun.com/document_detail/378657.html。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        config.endpoint = "imp.aliyuncs.com";

        // Input Parameters
        String appId = "********"; // 在控制台创建应用后生成。包含小写字母、数字，长度为6个字符。
        String appKey = "******"; // 在控制台创建应用后生成。小写英文和数字，长度32个字符。
        String userId = "*****"; // 在AppId下单独唯一。小写英文、数字、下划线（_）和小数点（.）组成，最大长度32个字符。
        String deviceId = "******"; // 小写英文、数字、下划线（_）和短横线（-）组成，最大长度64个字符。

        try {
            Client client = new Client(config);

            GetAuthTokenRequest request = new GetAuthTokenRequest();
            request.setAppId(appId);
            request.setAppKey(appKey);
            request.setUserId(userId);
            request.setDeviceId(deviceId);
            GetAuthTokenResponse response = client.getAuthToken(request);

            // 判断是否请求失败
            if (null == response) {
                // .....失败逻辑
            }

            // ....成功逻辑
            log.info("GetAuthToken response is : {}", JSON.toJSONString(response));

        } catch (Exception e) {
            // 异常处理
            e.printStackTrace();
        }
    }
}

后续步骤

请参见API概览，了解更多接口描述及示例。