用途:为 HarmonyOS 硬件能力检测、相机适配、传感器与外接设备提供统一接入与降级策略,覆盖 phone/tablet/pc/foldable/wearables/2in1。不涉及纯 UI 布局、无能力差异的普通业务逻辑、视频编解码与流媒体、第三方相机库。
主要能力:按场景索引组织。HW-01 能力检测与功能降级(canIUse、SysCap、module.json5,决定隐藏/置灰/替代/提示);HW-02 相机选择、预览与形态切换,含子场景折叠态重建、断点按钮布局、stride 防花屏、预览旋转与 Surface 宽高比、拍照/录像旋转、悬停态(仅显式触发);HW-03 传感器订阅、读取与解绑;HW-04 外接设备与热插拔。
使用方式:先做能力检测再调用 API,系统能力需同时检查 canIUse() 与 module.json5 声明;相机优先枚举设备,不硬编码相机 ID;传感器需说明注册、取消注册与生命周期解绑;外接设备需说明连接、断开与热插拔后的状态刷新。输出按阶段契约:REQ 输出 device_constraints、capability_boundary、acceptance_focus;DEV 输出 code_touchpoints、reuse_resources、implementation_notes、integration_risks;FIX 输出 problem_profile、root_cause_hypothesis、fix_plan、regression_watchlist;VAL 输出 verification_matrix、evidence_requirements、pass_criteria、residual_risks。
关键约束:折叠状态变化必须监听 foldStatusChange 并重建相机与预览流,半折叠态默认忽略;stride 与 width 不一致须去除无效像素;Surface 宽高比须匹配旋转后预览比例;预览旋转推荐 getPreviewRotation();拍照旋转须在 capture() 设置 rotation。
限制:阔折叠外屏可能仅有前置相机;2in1 多为前置内置相机,外接摄像头归 HW-04;sm 断点不支持旋转。具体 API 细节与代码示例见对应资源文件,资料未提供收费与价格信息。