跳到主要内容
本页面由机器自动翻译，可能包含错误。 查看英文原文

故障排除

常见问题​

初始化失败​

  • 确认你的 App ID 和 API Key 是否正确，以及触觉应用是否已在 Developer Portal 中部署。
  • 在 iOS 和 visionOS 上，initialize 会从服务器下载触觉事件。请检查设备是否已连接到互联网。
  • 在 macOS 上，请确保 bHaptics Player 已安装并正在运行。如果你的应用使用 App Sandbox，请启用 Outgoing Connections (Client)。

找不到设备​

  • 请仅在 bleStateChange 委托方法报告 true 之后再调用 scan()。在 Bluetooth 就绪之前扫描不会有任何效果。
  • 使用 getBluetoothState() 区分原因：3 表示用户拒绝了 Bluetooth 权限，4 表示 Bluetooth 已关闭。
  • 检查是否已在应用的 Info 设置中设置 NSBluetoothAlwaysUsageDescription。
  • iOS Simulator 和 visionOS Simulator 上无法使用 Bluetooth。请在真机上测试。
  • 确保触觉设备已开启，且未连接到其他手机或 PC。
  • 在 macOS 上，SDK 不会扫描设备。请在 bHaptics Player 中配对设备。

触觉效果无法播放​

  • 确认设备已配对并连接：getDevices() 返回的该设备满足 connected == true。
  • 确认事件名称存在于 getEventList() 中。事件名称区分大小写。
  • 请在 initialize 完成后再调用 play。初始化完成之前无法使用事件。
  • 检查设备电量。

仍有困扰？​