SuperAPI AI 工具集

using-mobile-native-capabilities

营销与增长

查看项目

更新于 10-15 21:43

技能介绍

用途:该技能帮助智能体为 Salesforce LWC 接入移动设备原生能力。lightning/mobileCapabilities 模块提供一组工厂函数,返回条码扫描、生物识别、定位、NFC、日历、联系人、文档扫描、地理围栏、支付、AR 空间捕捉、应用评价等能力的服务对象;每个服务都继承 BaseCapability 的 isAvailable() 方法,便于在桌面端或移动网页等不支持的环境优雅降级。

主要能力:技能引导智能体完成三步——(1) 将用户需求映射到能力索引中的某一项;(2) 加载共享引用(BaseCapability、mobile-capabilities 模块声明)及对应能力的 TypeScript API 参考;(3) 将服务接入 LWC,包含可用性判断、错误处理和避免使用已废弃 API。

使用方式:从 lightning/mobileCapabilities 导入工厂函数,例如 import { getBarcodeScanner } from 'lightning/mobileCapabilities'; 获取实例后先用 isAvailable() 判断,再调用推荐的非废弃入口(如条码用 scan(),而非 beginCapture/resumeCapture/endCapture),并用 try/catch 处理各服务定义的失败码枚举(如 BarcodeScannerFailureCode、LocationServiceFailureCode),区分用户取消、权限被拒、服务不可用等状态并给出可操作提示。

适用场景:需要调用设备原生能力的 LWC 开发,例如扫描条码写入字段、Apple Pay/Google Pay 支付、读取 GPS 坐标等。

限制:这些能力仅在受支持的 Salesforce 移动容器(Salesforce Mobile App、Field Service Mobile App)中可用,桌面端和移动网页上 isAvailable() 返回 false,必须每次调用前判断;不要凭记忆推断 API,应读取参考文件,因为服务会演进且部分方法已标记 @deprecated;若 isAvailable() 在真机返回 false,通常是应用环境不受支持或组织级设置限制,需调整配置而非代码。该技能不适用于 LWC 移动离线审查或通用 Lightning 基础组件选择。