일반적인 문제
초기화 실패
- 앱 ID와 API 키가 올바른지, 그리고 Developer Portal에서 햅틱 앱이 배포되었는지 확인하세요.
- iOS와 visionOS에서는
initialize가 서버에서 햅틱 이벤트를 다운로드합니다. 디바이스가 인터넷에 연결되어 있는지 확인하세요.
- macOS에서는 bHaptics Player가 설치되어 실행 중인지 확인하세요. 앱에서 App Sandbox를 사용한다면 **Outgoing Connections (Client)**를 활성화하세요.
디바이스를 찾을 수 없는 경우
bleStateChange delegate 메서드가 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를 호출하세요. 초기화가 끝나기 전에는 이벤트를 사용할 수 없습니다.- 디바이스 배터리 잔량을 확인하세요.
여전히 어려움이 있나요?