消息SDK对接

该文档用于描述通过SDK方式接收慧视云开放平台消息。开发者下载平台消息SDK，当前SDK只提供java版本，其他语言版本还未发布，如有需要请联系平台。

消息SDK通过TCP+TLS方式与平台建立长连接，通信报文采用定长报文形式。

SDK下载地址

1.SDK下载
2.SDK证书下载

SDK集成及使用说明

第一步：下载sdk jar包，将jar包整合到代码中，可通过maven方式集成：

        <dependency>
            <groupId>com.jovision.jcmp</groupId>
            <artifactId>mss-client</artifactId>
            <version>1.0.0</version>
            <scope>system</scope>
            <systemPath>${project.basedir}/libs/mss-client.jar</systemPath>
        </dependency>

​ 注意：需要创建libs目录，将mss-client.jar放入libs文件夹中，修改项目pom.xml文件引入。

第二步： 创建SDK客户端连接

    /**
     * 创建终端
     */
    private static void createTerminal() {
        // appID （租户id）在云平台--->控制台---->应用管理中获取
        String appId = "xxxxxx";
        // appKey,appSecret 在云平台--->控制台---->应用管理中获取
        String appKey = "xxxxxx";
        String appSecret = "xxxxxx";
        // 机器标识 （客户端的唯一标识）
        String imei = getMachineIdByInetAddress();
        // 服务器地址
        String serverHost = "https://openapi.cloudsee.com";
        // 证书地址
        String cChatPath = "mss-client.jks";
        // 证书密码
        String storePwd = "joviSioN@key456";
        // 证书密码
        String keyPwd = "JovisiOn@ckeypass987";

          // 创建SDK配置
        MpsConfig mpsConfig = new MpsConfig(appId, appKey, appSecret, imei, serverHost, cChatPath, storePwd, keyPwd, s -> System.out.println(s));
        // 创建SDK接收消息线程
        MpsClient mpsClient = new MpsClient(mpsConfig);
        mpsClient.start();
          // 其中 s -> System.out.println(s) 指定的是收到消息后的消息处理器，代码示例中收到消息后打印消息内容
    }

    /**
     * 获取机器id
     */
    public static String getMachineIdByInetAddress() {
        String hostName = null;
        try {
            hostName = InetAddress.getLocalHost().getHostName();
        } catch (UnknownHostException e) {
            e.printStackTrace();
            hostName = UUID.randomUUID().toString().replace("-", "");
        }
        return hostName;
    }

注意：开发者启动多个SDK实例时，需要保证 机器标识（imei） 唯一。并且同一条消息只会被其中一个实例消费。