Alaznah

Fix common Alaznah Calling integration issues.

Troubleshooting

SymptomLikely fix
Unable to resolve module / Metro path errorsRebuild; clear Metro cache (--reset-cache); ensure peers installed
Native module missing / nullRebuild the binary; Expo Go unsupported
Cannot connectReachable signalingUrl; device cannot use your laptop localhost without a tunnel
Auth / 401Token userId must match config.userId; mint a fresh token
No audioMic permission; check mute on both peers; physical device preferred
Black / no videoCamera permission; mediaType: 'video'; check videoEnabled
One-way mediaFirewall / ICE — try iceTransportPolicy: 'relay' with working TURN
No ring in backgroundConsole push credentials + registerPushToken + OS permissions
JS incoming flashes after native AcceptCall drainNativeIncomingAction() then syncPendingCalls() on AppState active
Accept “does nothing” on tapBy design — swipe up on the green control
Duplicate native + JS incomingsetNativeIncomingSuppressed(true) while in-app calling UI is mounted
iOS simulator CallKit crashDo not enable CallKeep / CallKit paths that disallow simulator

Still stuck?

Contact support with:

  • App ID / project id
  • Platform + OS version
  • @alaznah/calling version
  • Foreground vs background scenario
  • Relevant logs (no secrets)