@tencentcloud/sdk-mcp 1.7.7 → 1.7.9-beta.1

package/resource/knowledge/iot/app/integration/android.md

@@ -0,0 +1,328 @@
+---
+product: iot
+framework:
+  - android
+types:
+  - feature
+retrievable_scope: always
+feature_domain: app_integration
+---
+
+本文介绍如何在 Android 平台集成腾讯云物联网（IoT）应用端 SDK 并完成登录：涵盖工程配置、SDK 引入、登录签名计算与登录调用，并通过拉取家庭列表验证接入是否成功。设备绑定、设备分享、远程控制等能力在登录完成后按需接入，参见本文 [下一步](#c74dc1ed-b64a-4744-a1e1-9d9cb3eb7e49) 章节。
+
+## 前提条件
+
+### 开通服务
+
+请先按照 开通服务 文档，完成服务开通和应用创建，并获取以下信息：
+- **AppKey**：登录必需。
+
+- **AppSecret**：登录必需，用于计算登录签名。
+
+- **ProductId**：接入设备绑定、物模型等能力时使用，本文不涉及。
+
+- **DeviceName**：接入设备绑定、物模型等能力时使用，本文不涉及。
+
+### 环境准备
+- Android Studio 3.5 及以上版本。
+
+- 最低兼容 Android 4.4（SDK API Level 19），建议 Android 5.0（SDK API Level 21）及以上。
+
+## 创建项目
+
+参考以下步骤创建一个新的 Android 项目。如果已有项目，可跳过本节。
+1. 打开 Android Studio，选择 **New Project**（新建项目）。
+
+2. 选择 **Empty Views Activity** 模板，单击 **Next**。
+
+3. 在 **Configure your project** 页面配置：
+
+   - **Language** 选择 **Java**。
+
+   - **Minimum SDK** 建议 Android 5.0（API 21）及以上。
+
+   - **Build configuration language** 选择 **Groovy DSL (build.gradle)**。
+
+## 集成 SDK
+1. 在 **app/build.gradle**（非根目录的 build.gradle）的 **dependencies** 中添加 IoT SDK 依赖：
+
+   ``` groovy
+   dependencies {
+       // 物联网应用端 SDK
+       implementation 'com.tencent.liteav.customize:LiteAVSDK_Professional:13.4.0.25011'
+   }
+   ```
+2. 完成配置后，在 Android Studio 工具栏单击 **Sync Now**，SDK 将自动下载并集成到工程中。出现 Build successful 即表示成功。
+
+## 接入步骤
+
+### 步骤 1：获取 SDK 实例
+
+调用 `TXIoTEngine.getInstance` 获取 SDK 实例，注册登录、签名过期和设备状态推送监听。
+``` java
+TXIoTEngine iotEngine = TXIoTEngine.getInstance(getApplicationContext());
+iotEngine.addListener(new TXIoTEngine.TXIoTEngineListener() {
+    @Override
+    public void onLoginSuccess() {
+        // 登录成功
+    }
+
+    //其他回调省略实现
+});
+```
+
+### 步骤 2：计算登录签名
+
+> **说明：**
+> 快速接入阶段可直接在客户端计算签名进行调试。正式上线时请将签名计算逻辑放在业务后台，不要将 AppSecret 保存在客户端。
+>
+
+#### 签名参数
+
+参与签名的参数：
+
+|参数|说明|
+|---------|---------|
+|`RequestId`|唯一请求 ID，建议使用 UUID。|
+|`Timestamp`|当前 UNIX 秒级时间戳。|
+|`Nonce`|随机正整数，用于和时间戳一起防重放。|
+|`AppKey`|从 开通服务 文档获取的 AppKey。|
+|`OpenID`|用户标识，需与后续登录的 `userId` 保持一致。支持数字、字母、下划线，长度不超过 32 字节。|
+
+> **注意：**
+> OpenID 与 UserID 的关系：签名参数名为 **OpenID**，SDK 登录接口参数名为 **userId**，两者是同一个东西，值必须保持一致。
+>
+
+#### 签名计算规则
+1. 去掉值为空的参数。
+
+2. 将参数按参数名的字典序升序排列。
+
+3. 将排序后的参数按 `Key=Value` 格式拼接。
+
+4. 使用 `&` 连接所有参数，得到签名原文。
+
+5. 使用从 开通服务 文档获取的 `AppSecret` 对签名原文进行 HMAC-SHA1 签名。
+
+6. 对签名结果进行 Base64 编码，得到最终 `Signature`。
+
+#### 签名计算示例
+
+例如，参与签名的参数如下：
+``` text
+RequestId=8b8d499bbba1ac28b6da21b4
+Timestamp=1546315200
+Nonce=71087795
+AppKey=your_app_key
+OpenID=user_001
+```
+
+排序后的签名原文：
+``` text
+AppKey=your_app_key&Nonce=71087795&OpenID=user_001&RequestId=8b8d499bbba1ac28b6da21b4&Timestamp=1546315200
+```
+
+使用 `your_app_secret` 作为 AppSecret 对上述原文计算，期望得到的签名为 `aSLzd4Ett7RsiLhrYht6Yk9+0qY=`，可用于自验签名实现是否正确。
+
+参考以下示例计算签名。客户端示例基于 Java 标准库（Android 端 Base64 请使用 `android.util.Base64`）；正式上线时签名在业务后台计算，参考服务端示例：
+
+【客户端（Java）】
+``` java
+import javax.crypto.Mac;
+import javax.crypto.spec.SecretKeySpec;
+import java.util.Base64;
+import java.util.Map;
+import java.util.TreeMap;
+
+public class SignatureDemo {
+
+    static String generateSignature(String appSecret, String requestId, long timestamp,
+                                    int nonce, String appKey, String openId) throws Exception {
+        // TreeMap 按参数名的字典序升序排列
+        Map<String, String> params = new TreeMap<>();
+        params.put("RequestId", requestId);
+        params.put("Timestamp", String.valueOf(timestamp));
+        params.put("Nonce", String.valueOf(nonce));
+        params.put("AppKey", appKey);
+        params.put("OpenID", openId);
+
+        // 去掉值为空的参数，按 Key=Value 格式拼接，使用 & 连接
+        StringBuilder source = new StringBuilder();
+        for (Map.Entry<String, String> entry : params.entrySet()) {
+            if (entry.getValue() == null || entry.getValue().isEmpty()) {
+                continue;
+            }
+            if (source.length() > 0) {
+                source.append("&");
+            }
+            source.append(entry.getKey()).append("=").append(entry.getValue());
+        }
+
+        // 使用 AppSecret 对签名原文进行 HMAC-SHA1 签名
+        Mac mac = Mac.getInstance("HmacSHA1");
+        mac.init(new SecretKeySpec(appSecret.getBytes("UTF-8"), "HmacSHA1"));
+        byte[] digest = mac.doFinal(source.toString().getBytes("UTF-8"));
+
+        // 对签名结果进行 Base64 编码（Android 端请使用 android.util.Base64，flag 传 NO_WRAP）
+        return Base64.getEncoder().encodeToString(digest);
+    }
+
+    public static void main(String[] args) throws Exception {
+        String signature = generateSignature(
+                "your_app_secret",
+                "8b8d499bbba1ac28b6da21b4",
+                1546315200L,
+                71087795,
+                "your_app_key",
+                "user_001"
+        );
+        System.out.println(signature); // aSLzd4Ett7RsiLhrYht6Yk9+0qY=
+    }
+}
+```
+
+``` python
+import base64
+import hashlib
+import hmac
+
+def generate_signature(app_secret, request_id, timestamp, nonce, app_key, user_id):
+    params = {
+        "RequestId": request_id,
+        "Timestamp": str(timestamp),
+        "Nonce": str(nonce),
+        "AppKey": app_key,
+        "OpenID": user_id,
+    }
+    # 去掉值为空的参数
+    params = {
+        key: value
+        for key, value in params.items()
+        if value is not None and value != ""
+    }
+    # 按参数名的字典序升序排列
+    sorted_items = sorted(params.items(), key=lambda item: item[0])
+    # 按 Key=Value 格式拼接，使用 & 连接
+    source = "&".join([f"{key}={value}" for key, value in sorted_items])
+    # 使用 AppSecret 对签名原文进行 HMAC-SHA1 签名
+    digest = hmac.new(
+        app_secret.encode("utf-8"),
+        source.encode("utf-8"),
+        hashlib.sha1,
+    ).digest()
+    # 对签名结果进行 Base64 编码
+    signature = base64.b64encode(digest).decode("utf-8")
+    return signature
+
+signature = generate_signature(
+    app_secret="your_app_secret",
+    request_id="8b8d499bbba1ac28b6da21b4",
+    timestamp=1546315200,
+    nonce=71087795,
+    app_key="your_app_key",
+    user_id="user_001",
+)
+print(signature)
+```
+
+### 步骤 3：登录 SDK
+
+调用 `TXIoTEngine.login` 登录 SDK，传入上一步计算得到的签名参数。
+
+#### 参数说明
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| <code>appKey</code> | String | 从 开通服务 文档获取的 AppKey。 |
+| <code>userId</code> | String | 用户标识，支持数字、字母、下划线，长度不超过 32 字节。<br>首次使用会自动注册，已注册则登录原有账号，该账号下的设备绑定关系仍然保留。需与签名参数 <code>OpenID</code> 保持一致。 |
+| <code>userSignature.requestId</code> | String | 对应签名参数 <code>RequestId</code>。 |
+| <code>userSignature.timestamp</code> | long | 对应签名参数 <code>Timestamp</code>。 |
+| <code>userSignature.nonce</code> | int | 对应签名参数 <code>Nonce</code>。 |
+| <code>userSignature.signature</code> | String | 签名计算结果。 |
+
+``` java
+TXIoTEngine.TXIoTUserSignature userSignature = new TXIoTEngine.TXIoTUserSignature();
+userSignature.requestId = requestId;
+userSignature.timestamp = timestamp;
+userSignature.nonce = nonce;
+userSignature.signature = signature;
+
+iotEngine.login(appKey, userId, userSignature);
+```
+
+### 步骤 4：验证登录结果
+
+登录成功后，调用 `getFamilyManager` 获取家庭管理实例并拉取家庭列表，以此验证登录态与网络链路是否正常。返回的 `familyId` 是后续绑定设备、查询设备列表的必备参数，请妥善保存。
+``` java
+TXIoTFamilyManager familyManager = iotEngine.getFamilyManager();
+if (familyManager == null) {
+    // SDK 未登录或登录态已失效
+    return;
+}
+
+familyManager.getFamilyList(new TXIoTCallback<List<TXIoTFamilyInfo>>() {
+    @Override
+    public void onSuccess(List<TXIoTFamilyInfo> familyList) {
+        if (familyList.isEmpty()) {
+            // 当前账号下没有家庭，调用 createFamily 创建（见下方示例）
+            return;
+        }
+        // 选择一个家庭，记录 familyId
+        String familyId = familyList.get(0).familyId;
+    }
+
+    @Override
+    public void onError(TXIoTErrorCode errorCode, String errorMessage) {
+        // 获取家庭列表失败
+    }
+});
+```
+
+如果当前账号下没有家庭，可调用 `createFamily` 创建：
+``` java
+familyManager.createFamily("我的家庭", new TXIoTCallback<TXIoTFamilyInfo>() {
+    @Override
+    public void onSuccess(TXIoTFamilyInfo familyInfo) {
+        // 创建成功，记录 familyId
+        String familyId = familyInfo.familyId;
+    }
+
+    @Override
+    public void onError(TXIoTErrorCode errorCode, String errorMessage) {
+        // 创建家庭失败
+    }
+});
+```
+
+## 常见问题
+
+### 为什么 `getFamilyManager` 或 `getDeviceManager` 返回 `null`？
+
+SDK 尚未登录或登录态已失效。请先调用 `TXIoTEngine.login`，并在收到 `onLoginSuccess` 后再获取对应 Manager。
+
+### 登录签名过期后如何处理？
+
+当收到 `onUserSignatureExpired` 回调时，请重新计算登录签名，然后再次调用 `TXIoTEngine.login`。
+
+### 登录失败或提示签名错误如何排查？
+
+请按以下顺序逐项核对：
+1. `AppKey` 与 `AppSecret` 是否来自同一个应用且配对正确。
+
+2. 签名参数 `OpenID` 与登录接口的 `userId` 是否完全一致。
+
+3. `Timestamp` 是否为 UNIX 秒级时间戳（非毫秒），且与当前时间偏差在允许范围内。
+
+4. 参与签名的参数是否已去掉空值、并按参数名字典序升序排列后以 `&` 连接。
+
+5. 签名算法是否为 HMAC-SHA1，且签名结果经过 Base64 编码。
+
+   可使用 签名计算示例 中给出的期望输出（`aSLzd4Ett7RsiLhrYht6Yk9+0qY=`）自验签名实现是否正确。
+
+## 下一步
+
+完成基础接入后，您还可以继续接入以下能力：
+- 设备绑定
+
+- 远程控制
+
+- 家庭管理

package/resource/knowledge/iot/app/integration/harmonyos.md

@@ -0,0 +1,326 @@
+---
+product: iot
+framework:
+  - harmonyos
+types:
+  - feature
+retrievable_scope: always
+feature_domain: app_integration
+---
+
+本文介绍如何在鸿蒙（HarmonyOS）平台集成腾讯云物联网（IoT）应用端 SDK 并完成登录：涵盖工程配置、SDK 引入、登录签名计算与登录调用，并通过拉取家庭列表验证接入是否成功。设备绑定、设备分享、远程控制等能力在登录完成后按需接入，参见本文「下一步」章节。
+
+## 前提条件
+
+### 开通服务
+
+请先按照 开通服务 文档，完成服务开通和应用创建，并获取以下信息：
+- **AppKey**：登录必需。
+
+- **AppSecret**：登录必需，用于计算登录签名。
+
+- **ProductId**：接入设备绑定、物模型等能力时使用，本文不涉及。
+
+- **DeviceName**：接入设备绑定、物模型等能力时使用，本文不涉及。
+
+### 环境准备
+- DevEco Studio 5.0 及以上版本。
+
+- 一台 HarmonyOS NEXT 真机，且项目已配置有效的签名信息。
+
+## 创建项目
+
+参考以下步骤创建一个新的鸿蒙项目。如果已有项目，可跳过本节。
+1. 打开 DevEco Studio，选择 **Create Project**（新建项目）。
+
+2. 选择 **Application** 下的 **Empty Ability** 模板，单击 **Next**。
+
+3. 设置 **Project name**、**Bundle name**、**Compile SDK** 等项目基本信息，单击 **Finish** 完成创建。
+
+## 集成 SDK
+1. 将 SDK 的 HAR 包（如 `liteavsdk.har`）拷贝到模块目录下（例如 `entry/lib/`），并在模块的 `oh-package.json5` 中添加依赖：
+
+   ``` json5
+   // entry/oh-package.json5
+   {
+     "dependencies": {
+       "@tencentcloud/liteavsdk_iot": "file:./lib/liteavsdk.har"
+     }
+   }
+   ```
+2. 在模块的 `module.json5` 中声明所需权限。网络权限为必需；麦克风与摄像头权限在涉及语音对讲或视频通话时需要，且需在运行时向用户动态申请：
+
+   ``` json5
+   // entry/src/main/module.json5
+   {
+     "module": {
+       "requestPermissions": [
+         { "name": "ohos.permission.INTERNET" },
+         { "name": "ohos.permission.MICROPHONE" },
+         { "name": "ohos.permission.CAMERA" }
+       ]
+     }
+   }
+   ```
+3. 执行 **Sync Now** 同步依赖后，即可在 ArkTS 代码中引用 SDK：
+
+   ``` typescript
+   import { getIoTEngineInstance } from '@tencentcloud/liteavsdk_iot'
+   ```
+
+## 接入步骤
+
+### 步骤 1：获取 SDK 实例
+
+调用全局函数 `getIoTEngineInstance` 获取 SDK 单例，并注册 `TXIoTEngineListener` 监听登录、签名过期和设备状态推送。该单例在整个 App 生命周期内复用，以保证登录态在各页面间共享。
+``` typescript
+import { getIoTEngineInstance, TXIoTEngine, TXIoTEngineListener } from '@tencentcloud/liteavsdk_iot'
+
+// 获取单例实例（context 为可选参数）
+const iotEngine: TXIoTEngine = getIoTEngineInstance()
+
+// 注册监听：TXIoTEngineListener 为接口，所有回调均为可选，按需实现
+const engineListener: TXIoTEngineListener = {
+  onLoginSuccess: () => {
+    // 登录成功
+  },
+  onLoginFailure: (errCode, errMsg) => {
+    // 登录失败
+  },
+  onUserSignatureExpired: () => {
+    // 登录签名过期，请重新计算签名后再次调用 login
+  },
+  onReceivePushMessage: (pushMessage) => {
+    // 接收设备在线、离线等状态变更
+  }
+}
+iotEngine.addListener(engineListener)
+```
+
+### 步骤 2：计算登录签名
+
+> **说明：**
+> 快速接入阶段可直接在客户端计算签名进行调试。正式上线时请将签名计算逻辑放在业务后台，不要将 AppSecret 保存在客户端。
+>
+
+#### 签名参数
+
+参与签名的参数：
+
+|参数|说明|
+|---------|---------|
+|`RequestId`|唯一请求 ID，建议使用 UUID。|
+|`Timestamp`|当前 UNIX 秒级时间戳。|
+|`Nonce`|随机正整数，用于和时间戳一起防重放。|
+|`AppKey`|从 开通服务 文档获取的 AppKey。|
+|`OpenID`|用户标识，需与后续登录的 `userId` 保持一致。支持数字、字母、下划线，长度不超过 32 字节。|
+
+> **注意：**
+> **OpenID 与 UserID 的关系：**签名参数名为 **OpenID**，SDK 登录接口参数名为 **userId**，两者是同一个东西，值必须保持一致。
+>
+
+#### 签名计算规则
+1. 去掉值为空的参数。
+
+2. 将参数按参数名的字典序升序排列。
+
+3. 将排序后的参数按 `Key=Value` 格式拼接。
+
+4. 使用 `&` 连接所有参数，得到签名原文。
+
+5. 使用从 开通服务 文档获取的 `AppSecret` 对签名原文进行 HMAC-SHA1 签名。
+
+6. 对签名结果进行 Base64 编码，得到最终 `Signature`。
+
+#### 签名计算示例
+
+例如，参与签名的参数如下：
+``` plaintext
+RequestId=8b8d499bbba1ac28b6da21b4
+Timestamp=1546315200
+Nonce=71087795
+AppKey=your_app_key
+OpenID=user_001
+```
+
+排序后的签名原文：
+``` plaintext
+AppKey=your_app_key&Nonce=71087795&OpenID=user_001&RequestId=8b8d499bbba1ac28b6da21b4&Timestamp=1546315200
+```
+
+使用 `your_app_secret` 作为 AppSecret 对上述原文计算，期望得到的签名为 `aSLzd4Ett7RsiLhrYht6Yk9+0qY=`，可用于自验签名实现是否正确。
+
+参考以下示例计算签名。客户端示例基于系统自带的 CryptoFramework（加解密算法框架）；正式上线时签名在业务后台计算，参考服务端示例：
+
+【客户端（ArkTS）】
+``` typescript
+import cryptoFramework from '@ohos.security.cryptoFramework'
+import util from '@ohos.util'
+
+// 去掉空值参数，按参数名字典序升序排列后以 & 连接，得到签名原文
+function createSignSource(appKey: string, openId: string, requestId: string,
+                          timestamp: number, nonce: number): string {
+  const pairs = [
+    `AppKey=${appKey}`,
+    `Nonce=${nonce}`,
+    `OpenID=${openId}`,
+    `RequestId=${requestId}`,
+    `Timestamp=${timestamp}`
+  ]
+  return pairs.sort().join('&')
+}
+
+// 使用 AppSecret 对签名原文进行 HMAC-SHA1 签名，结果 Base64 编码
+async function generateSignature(appSecret: string, source: string): Promise<string> {
+  const encoder = new util.TextEncoder()
+  const symKeyGenerator = cryptoFramework.createSymKeyGenerator('HMAC')
+  const symKey = await symKeyGenerator.convertKey({ data: encoder.encodeInto(appSecret) })
+  const mac = cryptoFramework.createMac('SHA1')
+  await mac.init(symKey)
+  await mac.update({ data: encoder.encodeInto(source) })
+  const result = await mac.doFinal()
+  return new util.Base64Helper().encodeToStringSync(result.data)
+}
+```
+
+【服务端（Python）】
+``` python
+import base64
+import hashlib
+import hmac
+
+def generate_signature(app_secret, request_id, timestamp, nonce, app_key, user_id):
+    params = {
+        "RequestId": request_id,
+        "Timestamp": str(timestamp),
+        "Nonce": str(nonce),
+        "AppKey": app_key,
+        "OpenID": user_id,
+    }
+    # 去掉值为空的参数
+    params = {
+        key: value
+        for key, value in params.items()
+        if value is not None and value != ""
+    }
+    # 按参数名的字典序升序排列
+    sorted_items = sorted(params.items(), key=lambda item: item[0])
+    # 按 Key=Value 格式拼接，使用 & 连接
+    source = "&".join([f"{key}={value}" for key, value in sorted_items])
+    # 使用 AppSecret 对签名原文进行 HMAC-SHA1 签名
+    digest = hmac.new(
+        app_secret.encode("utf-8"),
+        source.encode("utf-8"),
+        hashlib.sha1,
+    ).digest()
+    # 对签名结果进行 Base64 编码
+    signature = base64.b64encode(digest).decode("utf-8")
+    return signature
+
+signature = generate_signature(
+    app_secret="your_app_secret",
+    request_id="8b8d499bbba1ac28b6da21b4",
+    timestamp=1546315200,
+    nonce=71087795,
+    app_key="your_app_key",
+    user_id="user_001",
+)
+print(signature)
+```
+
+### 步骤 3：登录 SDK
+
+调用 `TXIoTEngine.login` 登录 SDK，传入上一步计算得到的签名参数。
+
+#### 参数说明
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| <code>appKey</code> | string | 从 开通服务 文档获取的 AppKey。 |
+| <code>userId</code> | string | 用户标识，支持数字、字母、下划线，长度不超过 32 字节。<br>首次使用会自动注册，已注册则登录原有账号，该账号下的设备绑定关系仍然保留。需与签名参数 <code>OpenID</code> 保持一致。 |
+| <code>userSignature.requestId</code> | string | 对应签名参数 <code>RequestId</code>。 |
+| <code>userSignature.timestamp</code> | number | 对应签名参数 <code>Timestamp</code>。 |
+| <code>userSignature.nonce</code> | number | 对应签名参数 <code>Nonce</code>。 |
+| <code>userSignature.signature</code> | string | 签名计算结果。 |
+
+``` typescript
+import { TXIoTUserSignature } from '@tencentcloud/liteavsdk_iot'
+
+const userSignature = new TXIoTUserSignature()
+userSignature.requestId = requestId
+userSignature.timestamp = timestamp
+userSignature.nonce = nonce
+userSignature.signature = signature
+
+iotEngine.login(appKey, userId, userSignature)
+```
+
+### 步骤 4：验证登录结果
+
+登录成功后，调用 `getFamilyManager` 获取家庭管理实例并拉取家庭列表，以此验证登录态与网络链路是否正常。返回的 `familyId` 是后续绑定设备、查询设备列表的必备参数，请妥善保存。
+``` typescript
+const familyManager = iotEngine.getFamilyManager()
+if (!familyManager) {
+  // SDK 未登录或登录态已失效
+  return
+}
+
+familyManager.getFamilyList({
+  onSuccess: (familyList) => {
+    if (familyList.length === 0) {
+      // 当前账号下没有家庭，调用 createFamily 创建（见下方示例）
+      return
+    }
+    // 选择一个家庭，记录 familyId
+    const familyId = familyList[0].familyId
+  },
+  onError: (errorCode, errorMessage) => {
+    // 获取家庭列表失败
+  }
+})
+```
+
+如果当前账号下没有家庭，可调用 `createFamily` 创建：
+``` typescript
+familyManager.createFamily('我的家庭', {
+  onSuccess: (familyInfo) => {
+    // 创建成功，记录 familyInfo.familyId
+  },
+  onError: (errorCode, errorMessage) => {
+    // 创建家庭失败
+  }
+})
+```
+
+## 常见问题
+
+### 为什么 `getFamilyManager` 或 `getDeviceManager` 返回 `null`？
+
+SDK 尚未登录或登录态已失效。请先调用 `TXIoTEngine.login`，并在收到 `onLoginSuccess` 后再获取对应 Manager。
+
+### 登录签名过期后如何处理？
+
+当收到 `onUserSignatureExpired` 回调时，请重新计算登录签名，然后再次调用 `TXIoTEngine.login`。
+
+### 登录失败或提示签名错误如何排查？
+
+请按以下顺序逐项核对：
+1. `AppKey` 与 `AppSecret` 是否来自同一个应用且配对正确。
+
+2. 签名参数 `OpenID` 与登录接口的 `userId` 是否完全一致。
+
+3. `Timestamp` 是否为 UNIX 秒级时间戳（非毫秒），且与当前时间偏差在允许范围内。
+
+4. 参与签名的参数是否已去掉空值、并按参数名字典序升序排列后以 `&` 连接。
+
+5. 签名算法是否为 HMAC-SHA1，且签名结果经过 Base64 编码。
+
+   可使用「签名计算示例」中给出的期望输出（`aSLzd4Ett7RsiLhrYht6Yk9+0qY=`）自验签名实现是否正确。
+
+## 下一步
+
+完成基础接入后，您还可以继续接入以下能力：
+- 设备绑定
+
+- 远程控制
+
+- 家庭管理