客户在自己的手机上成功开了一次灯,安装人员收起工具离开。这看起来像交付结束,也可能只是多了一个能开灯的账户:设备仍在安装人员创建的家庭里,客户得到的是分享,安装账户依然持有管理入口。
交接要同时证明两件事:客户获得约定的管理能力,安装人员失去不再需要的控制能力。 只验前一件,会把临时调试关系留成长期权限。选哪种涂鸦 App 路线,应从最终由谁管理整个家庭、交付的是整套安装还是其中一台设备开始,而不是从哪个按钮最容易调用开始。
下面以一套新装灯控的假设交付说明选择方法,不是客户项目复盘,也没有账户迁移或实机验收结果。接口依据是 2026 年 11 月 17 日可读的 Android SmartLife App SDK / Extension SDK 官方文档;这是公开接口范围的判断,不是一份经指定 SDK 二进制版本编译运行的示例。
客户拿到的,究竟是哪一种关系
先在交付单写一个可检查的终态:“客户是这套安装所在家庭的最终管理者;安装账户没有持续控制权;售后需要客户重新授权。” 这句话会排除一个看似省事的做法——安装公司长期用自己的账户持有客户家庭,再把设备分享出去。
涂鸦的家庭成员管理文档把家庭角色与家庭转移放在同一管理体系里;设备分享文档则描述另一类接收关系。两者不是同一个操作换了名称。项目应按集成版本的权限表核对客户能做什么,不能因为界面能打开控制面板,就推定他拥有设备移除、成员管理或后续交接能力。
| 交付对象 | 可考虑的路线 | 必须另外付出的代价 |
|---|---|---|
| 新装的一整套家庭,客户应长期管理 | 尽早让客户建立最终家庭,安装人员只在明确授权下参与 | 客户账户与到场节奏要提前协调,不能完全依赖安装人员离线代办 |
| 临时家庭中只有这位客户的一整套安装 | 核对家庭所有者转移是否符合终态 | 操作影响的是整个家庭范围,转移后仍要核对原安装账户的剩余角色 |
| 客户只需使用别人持有的一台设备 | 核对产品支持后使用设备分享 | 使用权不自动等于管理权,分享的撤销和故障责任需单独说明 |
| 要从混合测试家庭分离某位客户的设备 | 制定逐设备解绑、重新配网与关联重建方案 | 可能需要现场操作、停用窗口与重新验收,不应直接转移整个测试家庭 |
这张表不是通用迁移指令。新设备、已投入使用的设备,以及经由网关接入的子设备,转移成本可能不同。先确认设备清单与客户范围,再允许执行具有破坏性的动作;演示环境里“删了重加没问题”,不足以授权现场照做。
分享方便,但它回答的是“再让谁使用”
设备分享适合家庭主体不变、只增加协作者的场景。例如屋主让一位家人使用某个设备,或者交付合同明确只提供受限使用入口。它不适合被默认为品牌向客户移交管理责任的替代品:客户可能看到设备,却无法完成下一次住户更换时需要的管理任务。
官方分享接口区分分享发起方与接收方,且提供能力查询。这里可以得到一个直接的产品设计要求:交付页应显示“设备分享”还是“家庭成员”,不要把所有关系都包装成模糊的“已添加”。具体产品能否分享、接收后可做哪些动作,要对照所用模块及产品能力,不从另一种设备的演示推导。设备分享 API
如果选择分享,验收至少包含接收、正常使用和撤销后的重新请求三个阶段。撤销后,在接收方旧页面仍显示设备,不一定证明仍可操作;反过来,设备从列表消失也不证明缓存页面、另一个已登录终端或其他授权路径全部失效。应记录服务端返回与设备状态,不只截图一个列表。
不要把“删除最近联系人”当成“撤销设备分享”。联系人、分享关系、家庭成员是不同对象。开发者需要按官方接口描述选择操作,并在操作后重新查询对应关系;若只能找到一个相似名称的方法,应该先停在确认范围,而不是用删除设备来代替撤权。
整个家庭可以交接,不代表任何设备都能单独转移
Android Extension SDK 文档中的 transferOwner(homeId, memberId, callback) 以家庭和成员为对象,前提是由家庭所有者向家庭成员转移角色。它并不是接受任意设备 ID、任意陌生账户的通用单设备迁移接口。调用前应让客户在正确家庭关系中就绪,再检查目标成员和这次要交接的安装范围。家庭转移接口
在假设的灯控安装里,如果临时家庭只有这位客户的设备,可以评估整家庭交接;如果里面混着公司展示灯、另一户的控制器或安装人员自己的网关,先转移再清理就把不属于客户的对象一并卷入了变更。此时宁可多安排一次迁移窗口,也不要把一个家庭级操作包装成单设备按钮。
角色转移后,重新读取家庭成员列表,确认客户的角色,再处理安装账户。不要凭“所有者已经变了”推定原所有者已经退出;也不要在客户尚未确认接管前把唯一可恢复入口撤掉。具体 SDK 对旧成员的角色结果必须实查,本篇不假定转移后自动删人或自动降权。
一个交付界面可以分开显示三种状态:客户已接受关系、客户管理能力已验证、安装账户已退出。最后一项没有通过,整单就仍是“交接中”。这不是要求涂鸦提供一个新状态枚举,而是品牌 App 或工单系统应该持有的业务状态;接口成功回调只完成其中一部分。
移除、恢复出厂与换客户,是不同的决定
对必须重新绑定的设备,先写清数据、网络和场景如何处理,再选 API。Android 设备管理文档把移除与恢复出厂分成不同操作。不能因为现场口头说了“重置一下”,就默认允许清除全部设置;也不能把云侧关系变化当成设备端已经擦除的证据。
交付前应问:设备是否在线?谁能接触复位键?原有定时、群组、联动、通知接收方是否需要保留?子设备重配会不会影响网关下其它对象?这些问题未必都由同一接口处理。界面上一个“迁移完成”,不应隐藏仍需现场重新配网或重建关联的工作。
如果设备离线,且没有来自设备端的有效结果,就没有依据宣布远程复位或数据擦除已经完成。离线移交应保留未完成状态,核对产品支持的恢复路径,必要时安排实体接触;不能靠重复发送远程复位命令让工单看起来在推进。这是结果验收原则,不是对所有涂鸦设备离线行为的统一保证。
如果客户只是要求安装人员退出,并没有要求换家庭或清数据,应优先检查能否撤销相应关系。为解决一个权限问题让全套设备重新配网,可能增加不必要的现场成本。只有关系范围不能满足终态时,再升级到设备迁移,并把停用及恢复验收写入交付计划。
双账户验收:不是两个人轮流看同一部手机

生成场景仅说明两个独立操作入口,不是涂鸦界面截图,也不能证明已经撤权或完成设备验收。
准备客户账户与安装账户,分别在独立会话中验证;不要把安装人员退出登录后、客户登录成功当成撤权试验,那只是换了界面。保留交接前的关系快照和执行时间,交接后重新读取家庭成员、分享关系及客户任务所需的设备状态。
验收动作应使用低风险测试设备,并由有权限的人明确批准。客户侧验证约定的查看、控制和管理任务;安装侧验证新的请求已不再具备原控制权限,区分明确拒绝、网络超时和结果未知。超时不能算撤权成功,设备没有动作也可能只是离线。旧会话与重新登录后的新会话都值得检查,避免仅验证缓存被清空。
安装账户退出后,还应盘点不属于该家庭成员关系的入口:是否另有设备分享、其他安装账户、第三方平台授权或独立云端业务账号。这些是额外核对项,并不意味着一次家庭转移能自动清掉全部路径。交付清单只应声称已实际验证的范围,不能承诺“所有外部权限已清零”却没有逐项证据。
如果客户侧通过、安装侧结果未知,保留“客户可用,撤权待确认”,不要合并成成功。保存脱敏的账户标识、关系类型、操作对象、版本、回调结果和状态回读即可;不要把密码、验证码或完整密钥写入工单。SDK 版本与 App 标识必须来自实际依赖与部署配置,不能从网页更新时间猜测。
售后入口应该重新打开,而不是从未关闭
售后再次进入客户系统,应说明此次要查看或操作什么,由客户通过产品支持的关系重新授权,并在工单结束后核对撤销。若需要自动到期,应由经过验证的产品能力或业务服务实施,不能因为工单填了结束时间就宣称 SDK 会自动收回权限。
对需要持续托管的商用项目,可以约定保留专门运维主体,但那是另一种服务合同与权限设计。不要一边按一次性交付报价,一边悄悄保留安装人员个人账户作远程维护后门。家庭模型是否适合多门店、多承租人和长期托管,也应在选型阶段判断;不能用不断叠加家庭成员来代替完整的组织权限方案。
因此,交接路线可以很简单:新装时尽量让客户尽早成为最终管理者;确需代建时先确认整个家庭是否属于交付范围;只需协作使用时才选择分享;必须重绑时则把设备、数据和关联重建单独验收。最后再证明安装人员确实退出。省掉这一步,省下的是交付当天几分钟,留下的却是客户下一次换人、报修和追责时无法解释的控制关系。
需要先判断产品应选哪类 App,可阅读公版 App、OEM App 与 App SDK 的选择。如果要把账户、交接和售后流程落到自己的品牌 App,工作范围应包含关系模型、失败恢复和双账户验收,而不只是配网与面板;可进一步了解涂鸦 App 定制开发。