// ...

// 请求成功 = 拿到业务数据，就这么简单
TopicInfo topic = client.executeSync(
    BemfaRequestApis.v1.Device.getTopicApiBuilder()
        .topicId("yourTopic")
        .topicType(TopicType.MQTT)
        .build()
);
// topic 已经是强类型对象，可以直接使用
System.out.println(topic.getNickname());

// JVM 环境
BemfaConfig config = new BemfaConfig();

// Android 环境 — 必须用 AndroidBemfaConfig，否则拿不到平台专属功能
AndroidBemfaConfig config = new AndroidBemfaConfig();

// JVM 环境
BemfaConfig config = BemfaClient.getConfig(BemfaConfig.class);

// Android 环境 — 必须传 AndroidBemfaConfig.class
AndroidBemfaConfig config = BemfaClient.getConfig(AndroidBemfaConfig.class);

// 初始化时开启
AndroidBemfaConfig config = new AndroidBemfaConfig();
config.setHttpLifecycleAutoManaged(true);
BemfaClient.init(config);

// 也可以动态调整
BemfaClient.getConfig(AndroidBemfaConfig.class).setHttpLifecycleAutoManaged(true);

// 请求时把 Activity 作为 tag 传入
String time = http.executeSync(api, MainActivity.this);                       
// Activity 销毁时，SDK 将自动取消该 Activity 名下的所有在途请求

BemfaConfig config = new BemfaConfig();
config.setLogLevel(LogLevel.INFO);
BemfaClient.init(config);

HttpClient client = BemfaClient.getHttpClient();

// 使用手机号登录（还支持邮箱登录）
client.executeSync(
    BemfaRequestApis.v1.User.loginWithPhoneApiBuilder()
        .phone("yourPhone")
        .password("yourPassword")
        .area("86")
        .build()
);
// 也可以使用 UID 登录
// BemfaClient.loginByUid("yourUid");

// 创建设备主题
client.executeSync(
    BemfaRequestApis.v1.Device.createTopicApiBuilder()
        .topicId("yourTopic")
        .topicType(TopicType.MQTT)
        .nickname("客厅灯")
        .build()
);

// 获取所有主题，直接拿到 TopicInfos 对象，不用解析 JSON
TopicInfos topics = client.executeSync(
    BemfaRequestApis.v1.Device.getAllTopicApiBuilder()
        .topicType(TopicType.MQTT)
        .build()
);

// 推送消息
client.executeSync(
    BemfaRequestApis.v1.Device.pushMessageApiBuilder()
        .topicId("yourTopic")
        .topicType(TopicType.MQTT)
        .message("开灯")
        .build()
);

// ...

BemfaClient.close();

AndroidBemfaConfig config = new AndroidBemfaConfig();
config.setHttpLifecycleAutoManaged(true);  // 开启后请求自动跟随 Activity 生命周期
BemfaClient.init(config);

// 防止线程阻塞，需在后台线程执行 HTTP 请求
new Thread(() -> {
    // 手机号登录（还支持邮箱登录）
    BemfaClient.getHttpClient().executeSync(
        BemfaRequestApis.v1.User.loginWithPhoneApiBuilder()
            .phone("yourPhone")
            .password("yourPassword")
            .area("86")
            .build()
    );
}).start();

// 也可以使用 UID 登录：
// BemfaClient.loginByUid("yourUid");

new Thread(() -> {
    try {
        HttpClient http = BemfaClient.getHttpClient();

        // 获取主题信息，直接拿到强类型 TopicInfo 对象，不用解析 JSON
        TopicInfo topic = http.executeSync(
            BemfaRequestApis.v1.Device.getTopicApiBuilder()
                .topicId("yourTopic")
                .topicType(TopicType.MQTT)
                .build(),
            MainActivity.this   // 传入 Activity 作为 tag，页面销毁时自动取消请求
        );

        runOnUiThread(() -> textView.setText("主题昵称：" + topic.getNickname()));
    } catch (RequestCanceledException e) {
        // 页面已销毁，请求被自动取消，无需处理
    } catch (BemfaSdkException e) {
        // 其他 SDK 异常（网络 / 业务 / HTTP 等）统一兜底
        runOnUiThread(() -> showError(e));
    }
}).start();

// 异步调用本身可在主线程发起；回调运行在后台线程，更新 UI 需 runOnUiThread 包起来
BemfaClient.getHttpClient().executeAsync(
    BemfaRequestApis.v1.Device.getTopicApiBuilder()
        .topicId("yourTopic")
        .topicType(TopicType.MQTT)
        .build(),
    new RequestCallback<TopicInfo>() {
        @Override
        public void onSuccess(TopicInfo topic) {
            runOnUiThread(() -> textView.setText("主题昵称：" + topic.getNickname()));
        }

        @Override
        public void onError(BemfaSdkException e) {
            runOnUiThread(() -> textView.setText("请求失败：" + e.getMessage()));
        }
    }
);

BemfaClient.close();

// 一：使用集中访问点（推荐）
BemfaRequestApi<Void> apiA = BemfaRequestApis.v1.User.loginWithPhoneApiBuilder()
        .phone("yourPhone")
        .password("yourPassword")
        .area("86")
        .build();
// 或者
LoginWithPhoneApi apiB = BemfaRequestApis.v1.User.loginWithPhoneApiBuilder()
        .phone("yourPhone")
        .password("yourPassword")
        .area("86")
        .build();

// 二：直接使用相应的 API Builder
LoginWithPhoneApi apiC = LoginWithPhoneApi.builder()
        .phone("yourPhone")
        .password("yourPassword")
        .area("86")
        .build();
// 或者
LoginWithPhoneApi apiD = LoginWithPhoneApi.loginWithPhoneApiBuilder()
        .phone("yourPhone")
        .password("yourPassword")
        .area("86")
        .build()

// 三：当然你也可以直接在执行请求方法中构建 API
BemfaClient.getHttpClient().executeSync(BemfaRequestApis.v1.User.loginWithPhoneApiBuilder()
        .phone("yourPhone")
        .password("yourPassword")
        .area("86")
        .build());

HttpClient client = BemfaClient.getHttpClient();
BemfaRequestApi<String> api = BemfaRequestApis.v1.Time
        .getCurrentTimeApiBuilder()
        .type(1)
        .build();

// 同步：阻塞当前线程，直接返回结果，可 try-catch 捕获相关异常
String time = client.executeSync(api);

// 异步：不阻塞，结果在回调中返回
client.executeAsync(api, new RequestCallback<String>() {
    @Override
    public void onSuccess(String result) {
        System.out.println("成功：" + result);
    }

    @Override
    public void onBusinessError(BemfaSdkErrorCode errorCode, ApiBusinessException e) {
        System.err.println("业务错误：" + e.getMessage());
    }

    @Override
    public void onNetworkError(NetworkException e) {
        System.err.println("网络错误：" + e.getMessage());
    }

    @Override
    public void onResponseParseError(String responseBody, ApiResponseException e){
        System.err.println("响应解析错误：" + e.getMessage());
    }

    @Override
    public void onError(BemfaSdkException e) {
        System.err.println("其他错误：" + e.getMessage());
    }
});
// 如果对请求产生的错误不关心，也可以只实现回调接口的成功方法
client.executeAsync(api, new RequestCallback<String>() {
    @Override
    public void onSuccess(String result) {
        System.out.println("成功：" + result);
    }
});