mPaaS 我扫一扫ai需要额外配置吗？

在 mPaaS 中使用扫一扫 AI 功能时，确实需要进行一些额外的配置。以下是详细的配置步骤和注意事项：

1. 接入扫一扫 AI 组件

要使用扫一扫 AI 功能，您需要确保已接入 扫一扫 AI 组件。根据知识库中的信息，AI 识别能力是新增的功能，能够大幅增强远距离识别小码并自动放大的能力。

• Android 应用：

  • 如果您使用的是 原生 AAR 方式，请确保在 Application 类中初始化 mPaaS。
  • 如果您使用的是 组件化方式，则需要通过组件管理安装“扫一扫/扫一扫 AI”组件。

• iOS 应用：

  • 使用 mPaaS Xcode Extension 或 CocoaPods 添加扫码功能，并确保已包含 AI 识别能力。

• HarmonyOS NEXT 应用：

  • 使用 mppm 命令行工具添加扫一扫组件的 SDK，并验证接入是否成功。

2. 启用 AI 识别功能

在启动扫码功能时，您需要通过 ScanRequest 对象启用 AI 识别功能。以下是一个示例代码片段：

ScanRequest scanRequest = new ScanRequest();

// 开启 AI 识别小码并自动放大（仅 10.2.3 及以上基线支持）
scanRequest.setEnableAI(true);

注意：此功能仅在 10.2.3 及以上基线 中支持，因此请确保您的 mPaaS SDK 版本符合要求。

3. 动态权限申请

如果您的应用目标 SDK 版本为 targetSdkVersion 33 或更高版本，则需要动态申请媒体权限以支持相册图片的选择。具体操作如下：

• 在 AndroidManifest.xml 中添加以下权限声明：

  <uses-permission android:name="android.permission.READ_MEDIA_IMAGES"/>
  

• 在运行时动态申请该权限。如果用户拒绝授权，mPaaS 多媒体组件将无法获取系统相册中的图片。

4. 设置延时提示文案（可选）

如果您希望在扫码过程中显示延时提示文案，可以通过以下代码进行配置（仅 10.2.3 及以上基线支持）：

// 设置延时提示文案
scanRequest.setDelayTipText("延时x秒弹出toast");

// 设置延时提示时间（单位：毫秒）
scanRequest.setDelayTipTime(5000);

5. 权限控制配置

如果您的应用中同时接入了小程序功能，并且需要调用相机相关的 API（如扫码、选择图片等），则需要配置权限控制。例如：

• 配置权限 key 和文案提示：

  public static class PermissionConfig {
    public String action; // API 名称，例如 "scan"
    public String key;    // 权限 key，例如 "camera"
    public String desc;   // 提示文案，例如 "需要访问相机以完成扫码"
  }
  

注意：此扩展配置仅在后台已开启 小程序权限控制 时才可用。

6. 回归测试

在完成上述配置后，建议进行回归测试，确保以下功能正常工作： - 扫一扫 AI 的识别能力是否正常。 - 相册选择图片功能是否正常。 - 动态权限申请流程是否符合预期。

特别提醒：全量回归测试的设备中必须包含 Android 13 或以上版本 的设备。

通过以上步骤，您可以成功配置并使用 mPaaS 的扫一扫 AI 功能。如果有其他疑问，请随时咨询！