You need to enable JavaScript to run this app.
最新活动
大模型
产品
解决方案
定价
生态与合作
支持与服务
开发者
了解我们

关于Agora视频通话音频异常问题的技术咨询

Troubleshooting Agora Video Call Audio Issues: No Remote Audio, No Local Audio, or Both

Hey there, let’s break down how to fix those pesky Agora video call audio issues—nothing’s more frustrating than being on a call and either not hearing the other person, or realizing they can’t hear you (or both!). Let’s dive into each scenario and actionable fixes:

First, Run These Universal Checks

Before jumping into scenario-specific fixes, rule out these common culprits:

  • Verify Audio Permissions: Ensure your app has the necessary access. On Android, confirm RECORD_AUDIO is enabled in your manifest; on iOS, double-check you’ve added NSMicrophoneUsageDescription to Info.plist. For web, check that your browser has granted mic access (look for the mic icon in the address bar).
  • Test with Agora’s Official Demo: Grab the basic video call demo from Agora’s SDK package and run it. If the demo works flawlessly, the issue is in your project’s code, not the SDK itself.
  • Check Channel & Token Setup: Make sure you’re calling joinChannel with the correct channel name, valid token (if using authentication), and unique user ID. A misconfigured token or mismatched channel name can silently block audio streams.
  • Network Health: Poor network causes audio packet loss. Keep an eye on the onNetworkQuality callback—if latency is over 200ms or packet loss exceeds 5%, switch to a wired or stronger Wi-Fi connection.

Scenario 1: You Can’t Hear the Remote User’s Audio

If the other person’s voice is MIA, try these steps:

  • Confirm Remote User’s Mic Status: Ask them to check if they’ve muted their mic accidentally. You can also rely on Agora’s onRemoteAudioStateChanged callback—look for states like REMOTE_AUDIO_STARTING or REMOTE_AUDIO_ENCODING to confirm their stream is active.
  • Check Your Local Audio Output: Ensure your device’s speaker isn’t muted, volume is turned up, and you’re not connected to a disconnected Bluetooth device. On web, verify the browser’s audio output device in its media settings.
  • Confirm Stream Subscription: By default, Agora auto-subscribes to remote streams, but if you’ve manually disabled this, you’ll need to call subscribe for the remote user’s UID to receive their audio.
  • Inspect Audio Decoding: If you’ve customized audio decoding settings, make sure they match the remote user’s encoding parameters. Mismatched sample rates or bitrates can cause unplayable audio.

Scenario 2: Remote User Can’t Hear Your Audio

If you’re talking but no one can hear you, here’s what to do:

  • Test Your Mic Independently: Use a native app (like Voice Memos on iOS or Sound Recorder on Android) to record a short clip. If it doesn’t capture audio, your device’s mic is faulty—fix that first.
  • Check Agora’s Mic Capture: Monitor the onLocalAudioStateChanged callback. If it returns an error state (like LOCAL_AUDIO_FAILED), another app might be hogging the mic (most OSes block multiple apps from accessing the mic at once).
  • Double-Check Mute State: Accidentally calling muteLocalAudioStream(true) will silence your audio to remote users. Scan your code for any unintended mute calls, especially in button click handlers or state management logic.
  • Validate Audio Encoding: If you’ve tweaked audio encoding settings (sample rate, bitrate, channel count), ensure they fall within Agora’s supported ranges. Incorrect settings can make your stream unplayable for others.

Scenario 3: Neither Can Hear the Other

This is usually a combination of two separate issues—work through these steps:

  • Combine Scenario 1 & 2 Checks: Go through all the fixes for both no remote audio and no local audio. For example, you might lack mic permission, while the remote user has their speaker muted.
  • Verify Token Privileges: If you’re using tokens, make sure they’re generated with both publish and subscribe privileges. A token that only allows publishing won’t let you hear others, and vice versa.
  • Test Across Devices: Try the call on a different device (e.g., switch from your phone to a laptop). If the issue disappears, it’s likely a device-specific hardware or OS problem.

Pro tip: Always check Agora’s callback logs—they’re packed with details about audio stream states, errors, and network conditions. Most issues will leave a clear trail in those logs!

内容的提问来源于stack exchange,提问作者maxxfrazer

火山引擎 最新活动