SuperAPI AI 工具集

add-pen-input

编程与开发

查看项目

更新于 10-16 00:32

技能介绍

用途:这是 microsoft/power-platform-skills 中的内部实现技能,由 /add-native 在解析出 pen-input、signature 或 @microsoft/power-apps-native-pen-input 能力后路由调用。它负责生成或校验原生手写笔输入封装,并展示如何调用其原生 React Native API,适用于签名、墨迹、手绘和手写捕获场景。

主要能力:校验工作目录是否为已初始化应用(需存在 app.config.js、power.config.json、package.json 与 src);确认 @microsoft/power-apps-native-pen-input 已在 package.json 依赖中;写入或校验 src/native/penInput.ts,提供 captureSignature 与 stripDataUriPrefix,返回判别联合类型且不抛异常;成功时返回 PNG data URI(data:image/png;base64,...);用户取消返回非错误的 USER_CANCELLED;原生模块缺失返回 NATIVE_MODULE_MISSING。

使用方式:用户应调用 /add-native pen-input、/add-native signature 或 /add-native @microsoft/power-apps-native-pen-input。屏幕代码从 @/native/penInput 导入 captureSignature,传入 backgroundColor、strokeColor、strokeWidth 等选项,用普通 React Native Image 显示返回的 PNG。可选将签名保存到 Dataverse Image/File 列时,须使用生成的 service,Image 列可先 stripDataUriPrefix 去除前缀,File 列须先保存父行再上传字节,不得把 File 字节放入 create/update JSON。最后运行 npx --no-install tsc --noEmit 做类型检查。

限制:该技能不会安装原生代码,也不会编辑原生配置;若包不在依赖中则停止,不执行 npm install、npx expo install、pod install 或修改 app.config.js。包必须已属于应用原生构建;若刚在技能外添加,需要在本工作流之外进行原生重建。不要使用 HostingSDK / PCF 路径,不要导入或注册 PenInputExtension,也不要接线 Companion PCF。颜色输入支持 #RGB 与 #RRGGBB。取消是正常路径,界面不应显示失败提示。该技能不编辑屏幕文件,屏幕侧保存与集成由所有者负责。