TTLockSDK 合规使用说明
更新日期:2026年8月6日
一、SDK 基本信息
| 项目 | 内容 |
|---|---|
| SDK 名称 | TTLockSDK |
| SDK 开发者 | 杭州通通锁智能科技股份有限公司 |
| OHPM 包名 | @ttlock/ttlock |
| 版本号 | 1.0.6 |
| SDK 类型 | 特定工具类(T/GIIC 0005—2025 附录 A) |
| 隐私政策 | https://cnopen.ttlock.com/document/doc?urlName=appSdkV3%2FharmonySDK%2FprivacyPolicy.html |
| OHPM 获取 | ohpm i @ttlock/ttlock |
二、集成前必读
- 请在应用 隐私政策 中披露 TTLockSDK 的名称、开发者、处理的个人信息类型,并附上 隐私政策链接。
- TTLockSDK 区分 基本业务功能 与 扩展业务功能;扩展功能均为可选,不调用对应 API 即不会触发相关个人信息处理。
- 涉及 指纹、人脸、掌静脉、IC 卡、密码 等敏感个人信息时,集成方须依法取得用户 单独同意,并在应用隐私政策中 加粗 提示。
- 集成方应遵循最小必要原则,仅申请业务所需的系统权限。
三、基本业务功能
基本业务功能为实现智能设备蓝牙通信与门锁核心管控所必需:
| 功能 | 说明 | 涉及信息 |
|---|---|---|
| 蓝牙扫描/连接 | 发现与连接智能锁等设备 | 蓝牙 MAC、设备名 |
| 门锁初始化 | 首次绑定设备 | lockData |
| 门锁控制 | 开锁、关锁 | lockData |
| 能力查询 | 查询设备功能支持情况 | lockData |
| WiFi 配网 | 配置门锁/网关网络 | WiFi 名称/密码 |
| 智能水电表 | 绑定、抄表、充值 | 设备标识、表计数据 |
| 无线键盘 | 绑定无线键盘 | 设备标识 |
四、扩展业务功能及关闭方式
扩展业务功能为可选能力。关闭原则:不集成、不调用、不授权。
| 扩展功能 | 使用目的 | 涉及可选个人信息 | 关闭/不使用方式 |
|---|---|---|---|
| 数字密码管理 | 添加/修改/删除门锁密码 | 密码 | 不调用 addPasscode、modifyPasscode、deletePasscode 等 API |
| 指纹管理 | 录入与管理指纹开锁 | 指纹 | 不调用 addFingerprint、modifyFingerprint、operationFingerprint 等 API |
| 人脸管理 | 录入与管理人脸开锁 | 人脸 | 不调用 addFace、modifyFace、deleteFace 等 API |
| 掌静脉管理 | 录入与管理掌静脉 | 掌静脉 | 不调用 addPalmVein、modifyPalmVein、deletePalmVein 等 API |
| IC 卡管理 | 录入与管理 IC 卡 | IC 卡 | 不调用 addICCard、modifyICCard、operationICCard 等 API |
| WiFi 门磁 | 门磁配置与控制 | 设备标识 | 不调用 TTWiFiDoorMagnetic 模块 |
| NFC 无源锁 | NFC 标签读写 | NFC 标签数据 | 不调用 TTNfcPassiveLock,不申请 NFC_TAG 权限 |
| 操作记录 | 读取设备操作日志 | 可能含用户标识 | 不调用 getOperationLog 等 API |
| OTA 升级 | 固件升级 | 设备标识 | 不调用 OTA 相关 API |
| 第三方蓝牙设备 | 管理第三方配件 | 设备标识 | 不调用 allowAddThirdPartyDevice 等 API |
| 本地调试日志 | 开发调试输出 | 设备标识、操作日志 | TTLock.printLog(false) |
示例 1:仅使用基本开锁功能(推荐最小集成)
import { TTLock, TTControlAction } from '@ttlock/ttlock';
// 1. 关闭调试日志
TTLock.printLog(false);
// 2. 仅声明蓝牙权限(module.json5)
// ohos.permission.ACCESS_BLUETOOTH
// 3. 扫描并初始化
TTLock.startScanLock((scanModel) => {
TTLock.initLock(scanModel.mac, scanModel.lockVersion, {
success: (lockData) => {
// 保存 lockData,供后续控制使用
},
failure: (error) => { /* 处理错误 */ }
});
});
// 4. 开锁/关锁(不调用指纹/人脸/密码管理等扩展 API)
TTLock.controlLockWithControlAction(lockData, TTControlAction.unlock, {
success: () => {},
failure: (error) => {}
});示例 2:不使用指纹功能
// 不要调用以下 API:
// TTLock.addFingerprint(...)
// TTLock.modifyFingerprint(...)
// TTLock.operationFingerprint(...)
// TTLock.recoverFingerprint(...)
// TTLock.writeFingerprint(...)
// 在 UI 层隐藏指纹管理入口,并在隐私政策中说明未启用指纹功能示例 3:不使用水电表(避免网络权限与 HTTP 交互)
// 不要 import TTElectricMeter / TTWaterMeter
// 不要在 module.json5 中为水电表场景申请 INTERNET 权限
// 不要配置 open.ttlock.cn 的 clientId / accessToken五、可选个人信息清单
以下个人信息 仅在调用对应扩展 API 时 由 SDK 协助在本地与设备间处理:
| 可选个人信息 | 使用目的 | 使用场景 | 关闭方式 |
|---|---|---|---|
| 指纹 | 指纹开锁凭证录入与管理 | 用户主动添加指纹 | 不调用指纹相关 API;UI 不提供入口 |
| 人脸 | 人脸开锁凭证录入与管理 | 用户主动添加人脸 | 不调用人脸相关 API |
| 掌静脉 | 掌静脉凭证录入与管理 | 用户主动添加掌静脉 | 不调用掌静脉相关 API |
| IC 卡 | 门卡凭证管理 | 用户主动添加 IC 卡 | 不调用 IC 卡相关 API |
| 密码 | 数字密码开锁管理 | 用户主动设置密码 | 不调用密码相关 API |
| WiFi 账号密码 | 设备连接路由器 | 用户主动配网 | 不调用 WiFi 配网 API |
| 操作记录 | 查询历史操作 | 用户/管理员查看记录 | 不调用操作记录 API |
| 调试日志 | 开发排错 | 开发/测试阶段 | TTLock.printLog(false) |
六、权限合规配置
按实际使用的功能模块申请权限,避免过度申请:
// module.json5 — 仅基本蓝牙锁功能
"requestPermissions": [
{
"name": "ohos.permission.ACCESS_BLUETOOTH",
"reason": "$string:bluetooth_reason",
"usedScene": {
"abilities": ["EntryAbility"],
"when": "inuse"
}
}
]| 功能场景 | 额外权限 |
|---|---|
| 水电表 / OTA HTTP | ohos.permission.INTERNET |
| NFC 无源锁 | ohos.permission.NFC_TAG |
| 蓝牙重连优化 | ohos.permission.PERSISTENT_BLUETOOTH_PEERS_MAC |
七、第三方 SDK 合规说明
TTLockSDK 集成第三方组件如下,集成方应在应用隐私政策的「第三方 SDK」章节中一并披露:
| 名称 | 包名 | 用途 | 隐私说明 |
|---|---|---|---|
| minizip | @ohos/minizip | ZIP 解压缩 | 不收集个人信息 |
八、应用隐私政策披露模板(供集成方参考)
为保障 [应用名称] 的智能门锁/设备管理功能,我们集成了 TTLockSDK。
SDK 名称:TTLockSDK
SDK 开发者:杭州通通锁智能科技股份有限公司
SDK 隐私政策:https://cnopen.ttlock.com/document/doc?urlName=appSdkV3%2FharmonySDK%2FprivacyPolicy.html
涉及个人信息类型:蓝牙设备标识、lockData;如启用扩展功能,还可能涉及 指纹、人脸、掌静脉、IC 卡、密码 等敏感个人信息。
使用目的:实现智能设备的绑定、控制与管理。
关闭方式:您可在应用内关闭/不使用相应功能模块;我们不会启用您未授权的功能。
九、联系我们
SDK 开发者:杭州通通锁智能科技股份有限公司
隐私事务邮箱:chensg@ttlock.com
