旋转矢量 CV 交叉检验

测试图案缩略图

图 1. 测试图案的缩略图。请下载上方链接的完整分辨率图片。

本页面将介绍对旋转矢量传感器实现的兼容性正确进行测试的步骤。如果设备声明具有 TYPE_ROTATION_VECTOR 复合传感器功能，则应该运行该测试。

测试

  1. 在接受测试的 Android 设备上安装 OpenCV Manager。
  2. 从 SourceForge.net 下载 OpenCV-3.0.0-android-sdk.zip 软件包。
  3. 从所下载归档文件内的 apk 文件夹中查找相关 APK。搭配使用 adb install 命令和 --bypass-low-target-sdk-block 选项，从计算机加载设备上的 APK。对于搭载 Android 13 或更低版本的设备，此 --bypass-low-target-sdk-block 选项不是必要的。如需了解详情，请参阅安装应用。

  4. 如果存在登录到 Google Play 的有效账号，请在 Google Play 中找到 OpenCV Manager，并在上下文菜单（“...”按钮触发的弹出式菜单）中停用“自动更新”。

    停用 OpenCV Manager 自动更新

    图 2. 在 Google Play 中停用自动更新。

  5. 打印链接的测试图案，并在打印时停用任何缩放选项。使用横向的 US Letter 纸张应该可以完整打印出该图案，您也可以使用更大尺寸的纸张打印。

    注意：上面正文中的图片分辨率较低，仅用于说明。请勿直接将其作为您的图案打印出来。

  6. 将该图案放在水平面上。
  7. 在 CTS 验证程序应用中启动旋转矢量 CV 交叉检验。按照下面的指南开启飞行模式，关闭自动屏幕旋转，并调整自适应亮度和位置信息（如果尚未进行这些更改）。
    测试开始

    图 3. 启动测试。

  8. 当视频预览出现时，将手机放置在图案上方三英尺（或一米）处，使主摄像头朝向图案且屏幕上的黄色标记与图案上的黄色标记在同一角落对齐。
    放置测试图案

    图 4. 放置测试图案。

  9. 使图案一直完全位于摄像头的取景范围内，同时围绕图案以三个不同的方向旋转被测 Android 设备 (DUT)：按照旋转范围指示图的提示，逐个方向进行旋转（1、2，然后是 3，如下图所示）。请保持平稳移动，以获得最准确的结果。
    设备移动操作

    图 5. 操控被测设备。

  10. 拍照完成后，摄像头预览画面将会消失，而分析过程则会开始。耐心等待分析完成；该过程通常需要一到五分钟，具体取决于手机的性能。分析完成后，手机会发出提示音并振动。如果分析成功，屏幕上会出现数值结果。
    测试完成

    图 6. 完成测试。

  11. 点击 NEXT 以转到通过/失败屏幕并查看结果。
    测试成功

    图 7. 通过测试。

  12. 按照以下提示进行操作以获得最准确的结果：
    1. 这是一个比较复杂的手动测试，因此您可能需要尝试多次以获得最佳效果。
    2. 测试之前，应对加速度计、陀螺仪和磁力计进行校准，以获得良好效果。

问题排查

  1. 症状：启动测试用例时或视频录制刚刚完成后测试就崩溃了。
    原因：可能存在 OpenCV Manager 兼容性问题。您可以检查 logcat 进行确认。如果确认是兼容性问题，则可以检查安装的 OpenCV Manager 的版本和架构。
  2. 症状：由于出现“太多无效帧”错误，测试频繁失败。
    原因：可能是由于视频质量较低所致。请确认以下条件：
    1. 有充足的环境光源便于进行测试。自然光线的效果通常最好。但是，如果没有自然光线，来自多个角度且不会形成明显阴影的充足光线也可以达到效果。避免低角度光线，以减少眩光。
    2. 在视频拍摄期间动作应保持平稳。抖动会导致画面变模糊，并使计算机视觉软件产生混淆。
    3. 图案应始终完全位于视频预览范围内，并靠近中心位置。图案的大小应为视频预览窗口大小的 1/4 ~ 1/2。如果图案太小，则准确度会降低。如果图案太大，则镜头失真会更加明显，而且更难于将图案始终保持在视频录制取景范围内。
    4. 摄像头能够很好地聚焦。某些设备在视频录制过程中难以聚焦。这通常是因为场景变化太少，例如纯色的光滑地板表面。将测试图案移到具有纹理表面的位置或在测试图案周围放置物品，通常有助于解决该问题。
    5. 防抖功能已关闭。
  3. 症状：Pitch 和 Roll 测试正常，但 Yaw 测试经常失败。
    原因：首先，确保磁场传感器校准结果正常。如果没有校准磁场传感器，则旋转矢量无法正常工作。
    此外，偏航轴也可能因拍摄视频而出现故障。对于 Yaw 测试，请让设备保持稳定，然后围绕测试图案行走/移动。用手旋转设备时很难保持视频质量。

提交反馈

如果上述步骤无法解决问题，请务必按照以下反馈步骤报告您的问题。

请在报告错误时收集以下信息：

  1. Android 错误报告
  2. 屏幕截图（如果屏幕上有任何错误消息）。
  3. /sdcard/RVCVRecData/ 的内容。该文件夹包含视频文件，因此如果已进行多次测试，该文件夹可能会非常大。清空该文件夹后再重新执行测试将有助于减小文件夹大小。检查其中的视频文件，找出录制方面的明显问题。
  4. OpenCV Manager 应用的屏幕截图。