Skip to content

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

二、集成前必读 ​

  1. 请在应用 隐私政策 中披露 TTLockSDK 的名称、开发者、处理的个人信息类型,并附上 隐私政策链接。
  2. TTLockSDK 区分 基本业务功能 与 扩展业务功能;扩展功能均为可选,不调用对应 API 即不会触发相关个人信息处理。
  3. 涉及 指纹、人脸、掌静脉、IC 卡、密码 等敏感个人信息时,集成方须依法取得用户 单独同意,并在应用隐私政策中 加粗 提示。
  4. 集成方应遵循最小必要原则,仅申请业务所需的系统权限。

三、基本业务功能 ​

基本业务功能为实现智能设备蓝牙通信与门锁核心管控所必需:

功能说明涉及信息
蓝牙扫描/连接发现与连接智能锁等设备蓝牙 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 HTTPohos.permission.INTERNET
NFC 无源锁ohos.permission.NFC_TAG
蓝牙重连优化ohos.permission.PERSISTENT_BLUETOOTH_PEERS_MAC

七、第三方 SDK 合规说明 ​

TTLockSDK 集成第三方组件如下,集成方应在应用隐私政策的「第三方 SDK」章节中一并披露:

名称包名用途隐私说明
minizip@ohos/minizipZIP 解压缩不收集个人信息

八、应用隐私政策披露模板(供集成方参考) ​

为保障 [应用名称] 的智能门锁/设备管理功能,我们集成了 TTLockSDK。

SDK 名称:TTLockSDK

SDK 开发者:杭州通通锁智能科技股份有限公司

SDK 隐私政策:https://cnopen.ttlock.com/document/doc?urlName=appSdkV3%2FharmonySDK%2FprivacyPolicy.html

涉及个人信息类型:蓝牙设备标识、lockData;如启用扩展功能,还可能涉及 指纹、人脸、掌静脉、IC 卡、密码 等敏感个人信息。

使用目的:实现智能设备的绑定、控制与管理。

关闭方式:您可在应用内关闭/不使用相应功能模块;我们不会启用您未授权的功能。


九、联系我们 ​

SDK 开发者:杭州通通锁智能科技股份有限公司

隐私事务邮箱:chensg@ttlock.com