Troubleshooting

Common issues and their solutions when working with ConoStream SDK.

Connection Issues

Cannot connect to room

Symptoms: Connection fails, timeout, or error callback received.

Solutions:

• Verify server URL is correct and uses wss:// protocol
• Check if token is valid and not expired
• Ensure device has internet connection
• Check server is running and accessible
• Verify firewall allows WebSocket connections (port 443, 7880)

// Debug connection
Log.d("ConoStream", "URL: " + serverUrl);
Log.d("ConoStream", "Token: " + token.substring(0, 20) + "...");

Token expired error

Solution: Generate a new token from your backend before connecting. Tokens typically expire after 1 hour.

Audio Issues

Audio plays through earpiece instead of speaker

Cause: SDK defaults to call mode (earpiece).

Solution: Configure audio AFTER room connects:

manager.connect(url, token, new ConoStreamEventListener() {
    @Override
    public void onConnected() {
        // IMPORTANT: Configure audio after connection
        manager.configureAudioForSpeaker();
    }
});

No audio from remote participants

Solutions:

• Check device volume is not muted
• Verify remote participant is publishing audio
• Check if subscription failed (see logs)

Echo or feedback

Solutions:

• SDK has built-in echo cancellation - ensure it's not disabled
• Use headphones during testing
• Lower speaker volume

Video Issues

Black screen on video view

Solutions:

• Initialize renderer before attaching track:

  renderer.init(eglContext, null);

• Ensure CAMERA permission is granted
• Check if camera is being used by another app
• Call setVisibility(View.VISIBLE) on the view

Video freezes

Solutions:

• Check network stability
• Reduce video quality/resolution
• SDK will auto-reconnect on network issues

Camera switch doesn't work

// Ensure camera is enabled first
if (videoHelper.isCameraEnabled()) {
    videoHelper.switchCamera();
}

PK Battle Issues

Opponent video not showing

Solutions:

• Verify opponent room URL and token are correct
• Initialize PK renderer before attaching
• Check onPkOpponentVideoReceived callback is set

Both sides show same video

Cause: Opponent channel name is same as main room.

Solution: Ensure you're using the correct opponent's channel from your backend.

Audio continues after leaving PK

Solution: Call cleanup methods:

videoHelper.leavePkOpponentRoom();
videoHelper.cleanupPkRenderers();

Build Issues

AAR not found

// Ensure AAR is in app/libs/
implementation files('libs/conostream-android-sdk-release.aar')

Duplicate class error

Solution: Exclude duplicate dependencies:

implementation('...') {
    exclude group: 'com.google.protobuf'
}

minSdk version error

Solution: ConoStream requires minSdk 21 or higher.

Debug Logging

Enable debug logs to troubleshoot issues:

// Filter logcat by tag
adb logcat -s ConoStream:* WebRTC:*

Still Need Help?