小天互连移动端 SDK 接入指南

引入依赖 → 工程配置 → Application 初始化 → 登录 → 注册监听
  → setHtImRouteListener → initHtImData → 调用功能入口

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        // 小天互连私有源（地址请向小天互连获取）
        maven { url '<小天互连私有源地址>' }

        // SDK 依赖的三方仓库，缺一不可
        maven { url 'https://maven.aliyun.com/repository/public' }
        maven { url 'https://jitpack.io' }
        maven { url 'https://developer.huawei.com/repo/' }                          // 华为 HMS Push
        maven { url 'https://mvn.getui.com/nexus/content/repositories/releases/' }  // 个推
        google()
        mavenCentral()

        // 本地 aar 目录（存放 htrtc 音视频包）
        flatDir { dirs 'repositories' }
    }
}

dependencies {
    implementation 'com.oa8000.htim:main:1.0.1'

    // htrtc 音视频包由私有源以外的渠道提供，需放入工程根目录 repositories/ 后本地引入
    implementation(name: 'htrtc-2.2.3', ext: 'aar')

    implementation 'io.reactivex.rxjava2:rxjava:2.2.3'
    implementation 'io.reactivex.rxjava2:rxandroid:2.1.0'
}

自动带出的模块

随依赖链引入的三方库：OkHttp 3.9.1 / Retrofit 2.4.0 / RxJava 2.2.3 / Glide 4.9.0 / Gson 2.8.5 / Room 2.5.0-alpha01 / MMKV 1.2.11 / LiveEventBus 1.5.7 / SmartRefreshLayout 1.1.0 / XXPermissions 16.6 / ImmersionBar 3.0.0 等，以及个推 gtsdk 3.2.14.0 + gtc 3.2.1.0 与华为/小米/OPPO/vivo 厂商推送通道。

gradle.properties

android.useAndroidX=true
android.enableJetifier=true          # SDK 依赖链中仍有 support 库，必须开启
android.nonTransitiveRClass=true
android.injected.testOnly=false      # 允许直接安装 debug 包到设备
org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8

app/build.gradle

android {
    compileSdk 33

    defaultConfig {
        minSdk 24
        targetSdk 33

        ndk {
            // SDK 的 native 库只有 arm64-v8a / armeabi-v7a
            abiFilters "arm64-v8a"
        }

        manifestPlaceholders = [
                // 个推 APPID（3.1.2.0 起占位符名为 GETUI_APPID）
                GETUI_APPID: "你的个推 AppId",
                // 高德地图 key（定位、位置消息、考勤打卡使用）
                AMAP_APIKEY: "你的高德 Key",
        ]
    }

    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }

    // SDK 的界面使用 DataBinding，宿主必须一并开启
    dataBinding { enabled = true }
    buildFeatures { viewBinding true }

    configurations {
        // 与 SDK 依赖链中的注解库冲突，必须排除
        implementation.exclude group: 'com.intellij', module: 'annotations'
    }
}

AndroidManifest.xml

SDK 与宿主都声明了 android:theme 与 android:allowBackup，需要用 tools:replace 指定以宿主为准：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">

    <application
        android:name=".MyApp"
        android:allowBackup="false"
        android:theme="@style/Theme.YourApp"
        tools:replace="android:theme, android:allowBackup"
        tools:targetApi="33">
        ...
    </application>
</manifest>

native 库

以下 .so 需放入 app/src/main/jniLibs/<abi>/（由小天互连随 SDK 提供）：

混淆

SDK 各模块自带 consumer-rules.pro，宿主开启 minifyEnabled 时只需补充地图相关规则：

-keep class com.baidu.** {*;}
-keep class vi.com.** {*;}
-keep class com.baidu.vi.** {*;}
-dontwarn com.baidu.**

SDK 各模块的 Manifest 已声明所需权限，合并后会自动进入宿主 App，无需手工重复声明。宿主需要关注的是：这些权限会出现在应用商店的权限清单里，以及 Android 6.0+ 的运行时授权。

Android 端必须在 Application.onCreate() 中初始化，且早于任何其他 SDK 调用。

public class MyApp extends Application {
    @Override
    public void onCreate() {
        super.onCreate();

        HtImInitConfig config = new HtImInitConfig();
        config.setHtrtcAppId("你的 htrtc appId");
        config.setHtrtcAppKey("你的 htrtc appKey");
        HtImClientManager.getInstance().initHtImSdk(this, config);

        // 服务端为自签证书时放行 HTTPS
        try {
            HttpsURLConnection.setDefaultSSLSocketFactory(SSLSocketClient.getSSLSocketFactory());
            HttpsURLConnection.setDefaultHostnameVerifier(SSLSocketClient.getHostnameVerifier());
        } catch (Exception e) {
            e.printStackTrace();
        }

        KLog.init(true);   // 开发期打开 SDK 日志，上线前置为 false
    }
}

@Override
public void onTerminate() {
    super.onTerminate();
    HtImClientManager.getInstance().cleanHtImSdk();
}

下拉刷新样式（建议）

SDK 的列表页使用 SmartRefreshLayout，宿主可在 Application 的静态块中统一配置全局头尾样式：

static {
    ClassicsFooter.REFRESH_FOOTER_LOADING = "加载中...";
    SmartRefreshLayout.setDefaultRefreshHeaderCreator(
            (context, layout) -> new ClassicsHeader(context));
    SmartRefreshLayout.setDefaultRefreshFooterCreator(
            (context, layout) -> new ClassicsFooter(context).setDrawableSize(20));
}

账号密码登录

HtImLoginConfig config = new HtImLoginConfig();
config.setServerUrl(url);            // 服务器地址
config.setLoginId(loginId);          // 登录账号 Id
config.setPassword(password);        // 登录密码
config.setLanguageType("CN");        // "CN"-中文 "EN"-英文

HtImClientManager.getInstance().doHtImLogin(config, new ServerInitCallbackListener() {
    @Override
    public void onSuccess() {
        loadingDialog.dismiss();
        startActivity(new Intent(LoginActivity.this, MainActivity.class));
    }

    @Override
    public void onError(int code, String error) {
        loadingDialog.dismiss();
        ToastUtils.showShort(error);
    }
});

令牌免密登录

HtImLoginConfig config = new HtImLoginConfig();
config.setServerUrl("http://im.example.com:31921");
config.setUserSdkKey(tokenFromYourBackend);   // 后端下发，勿硬编码
config.setLanguageType("CN");

HtImClientManager.getInstance().doHtImLogin(config, listener);

登录成功后，在承载功能入口的 Activity 中还需要完成两步初始化，否则模块间跳转、会话列表、未读数都不会工作。

HtImClientManager.getInstance().setHtImRouteListener(this);

HtImClientManager.getInstance().initHtImData(this);

HtImClientManager.getInstance().removeHtImRoutListener();

SDK 采用个推 + 厂商通道双通道方案：个推负责统一调度，厂商通道负责应用被杀后的到达率。 厂商通道的 SDK 已打进 com.oa8000.htim:main，宿主只需完成个推接入与两个 token 的上报。

① 申请并配置个推 AppId

在个推开放平台创建应用（包名需与宿主 App 一致），把 AppId 填入 manifestPlaceholders，并在 Manifest 中声明：

<application ...>
    <meta-data
        android:name="PUSH_APPID"
        android:value="你的个推 AppId" />

    <service
        android:name=".push.getui.HtGTPushService"
        android:exported="false"
        android:label="PushService"
        android:process=":pushservice" />
    <service android:name=".push.getui.HtGTIntentService" />
</application>

<queries>
    <!-- 个推适配 Android 11+ -->
    <intent>
        <action android:name="com.getui.sdk.action" />
    </intent>
</queries>

② 实现个推服务类

两个类都必须由宿主 App 自己实现并在 Manifest 中声明，个推才能回调：

public class HtGTPushService extends PushService {
}

public class HtGTIntentService extends GTIntentService {

    // 接收 CID —— 这是要上报给 SDK 的推送标识
    @Override
    public void onReceiveClientId(Context context, String clientid) {
        App.cidDeviceToken = clientid;
    }

    @Override
    public void onReceiveMessageData(Context context, GTTransmitMessage msg) {
        String data = new String(msg.getPayload());
        // 透传消息，按需自行处理
    }

    @Override public void onReceiveServicePid(Context context, int pid) { }
    @Override public void onReceiveOnlineState(Context context, boolean online) { }
    @Override public void onReceiveCommandResult(Context context, GTCmdMessage msg) { }
    @Override public void onNotificationMessageArrived(Context context, GTNotificationMessage msg) { }
    @Override public void onNotificationMessageClicked(Context context, GTNotificationMessage msg) { }
}

③ 登录时上报 token

把两类 token 写入登录配置，SDK 会拼成 vendorDeviceToken;cidDeviceToken 一并提交服务端：

config.setVendorDeviceToken(vendorToken);  // 厂商推送 token
config.setCidDeviceToken(cid);             // 个推 CID，非必填

Application

public class MyApp extends Application {

    @Override
    public void onCreate() {
        super.onCreate();

        HtImInitConfig config = new HtImInitConfig();
        config.setHtrtcAppId("你的 htrtc appId");
        config.setHtrtcAppKey("你的 htrtc appKey");
        HtImClientManager.getInstance().initHtImSdk(this, config);

        try {
            HttpsURLConnection.setDefaultSSLSocketFactory(SSLSocketClient.getSSLSocketFactory());
            HttpsURLConnection.setDefaultHostnameVerifier(SSLSocketClient.getHostnameVerifier());
        } catch (Exception e) {
            e.printStackTrace();
        }

        KLog.init(true);
    }

    @Override
    public void onTerminate() {
        super.onTerminate();
        HtImClientManager.getInstance().cleanHtImSdk();
    }

    static {
        ClassicsFooter.REFRESH_FOOTER_LOADING = "加载中...";
        SmartRefreshLayout.setDefaultRefreshHeaderCreator(
                (context, layout) -> new ClassicsHeader(context));
        SmartRefreshLayout.setDefaultRefreshFooterCreator(
                (context, layout) -> new ClassicsFooter(context).setDrawableSize(20));
    }
}

登录页

public class LoginActivity extends AppCompatActivity {

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_login);

        findViewById(R.id.textView).setOnClickListener(view -> {
            LoadingDialog loadingDialog = new LoadingDialog(this);
            loadingDialog.show("正在登录");

            HtImLoginConfig config = new HtImLoginConfig();
            config.setServerUrl(sUrl.getText().toString());      // 服务器地址
            config.setLoginId(sLoginId.getText().toString());    // 登录账号 Id
            config.setPassword(sPassword.getText().toString());  // 登录密码
            config.setLanguageType("CN");                        // "CN"-中文 "EN"-英文
            config.setVendorDeviceToken(vendorToken);            // 厂商推送 token
            config.setCidDeviceToken(cid);                       // 个推 CID，非必填

            HtImClientManager.getInstance().doHtImLogin(config, new ServerInitCallbackListener() {
                @Override
                public void onSuccess() {
                    loadingDialog.dismiss();
                    startActivity(new Intent(LoginActivity.this, MainActivity.class));
                }

                @Override
                public void onError(int code, String error) {
                    loadingDialog.dismiss();
                    ToastUtils.showShort(error);
                }
            });
        });
    }
}

功能入口页

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 1. 先注册监听
        HtImClientManager.getInstance().addHtImChatListener(new HtImChatListener() {
            @Override
            public void onRecentMsgUnreadNum(int unreadNum) {
                TextView tv = findViewById(R.id.chatMsgUnreadNum);
                tv.setVisibility(unreadNum > 0 ? View.VISIBLE : View.GONE);
                tv.setText(String.valueOf(unreadNum));
            }

            @Override
            public void onRecentToDoNum(int num) {
                TextView tv = findViewById(R.id.chatMsgToDoNum);
                tv.setVisibility(num > 0 ? View.VISIBLE : View.GONE);
                tv.setText(String.valueOf(num));
            }
        });

        // 2. 再注册路由，最后加载数据
        HtImClientManager.getInstance().setHtImRouteListener(this);
        HtImClientManager.getInstance().initHtImData(this);

        HtImClientManager mgr = HtImClientManager.getInstance();
        findViewById(R.id.textView)             .setOnClickListener(v -> mgr.openHtImWorkStation(this));         // 工作台
        findViewById(R.id.textView2)            .setOnClickListener(v -> mgr.openHtImChatMessage(this));         // 消息
        findViewById(R.id.textView3)            .setOnClickListener(v -> mgr.openHtImContact(this));             // 通讯录
        findViewById(R.id.textView_send_chat)   .setOnClickListener(v -> mgr.sendHtImChat(this));                // 发起聊天
        findViewById(R.id.textView_scan)        .setOnClickListener(v -> mgr.openHtImScanQr(this));              // 扫一扫
        findViewById(R.id.textView_send_email)  .setOnClickListener(v -> mgr.openHtImEmailSend(this));           // 发邮件
        findViewById(R.id.textView_todo)        .setOnClickListener(v -> mgr.openHtImPlatformTodo(this));        // 待办
        findViewById(R.id.textView_trace)       .setOnClickListener(v -> mgr.openHtImTraceTemplateSelect(this)); // 发起申请
        findViewById(R.id.textView_information) .setOnClickListener(v -> mgr.openHtImInformation(this));         // 信息发布
        findViewById(R.id.textView_chat_meeting).setOnClickListener(v -> mgr.openHtImChatMeeting(this));         // 视频会议
        findViewById(R.id.textView_ai)          .setOnClickListener(v -> mgr.openHtImAiAssistant(this));         // AI 助手

        findViewById(R.id.textView4).setOnClickListener(v -> {
            mgr.doHtImLogout(MainActivity.this);
            finish();
        });
    }

    @Override
    protected void onDestroy() {
        HtImClientManager.getInstance().removeAllHtImChatListener();
        super.onDestroy();
    }
}