public interface WebRtcBridge

Internal service-provider interface a port implements to carry the com.codename1.webrtc API onto its native WebRTC stack: Google’s org.webrtc on Android, the WebRTC framework on iOS, the browser’s RTCPeerConnection in the JavaScript port, and a loopback in the simulator.

Application code never touches this interface; the public classes reach it through com.codename1.ui.Display#getWebRtcBridge(), and a port that returns null there is a port without WebRTC – WebRtc.isSupported() says so and nothing else needs a platform if.

Everything is ids, primitives and strings

As with com.codename1.call.spi.CallBridge, no method takes or returns a framework type, so a port reached through ParparVM never constructs a Java object from native code. Peer connections and tracks are integer handles the port allocates; structured values cross as strings.

Every request answers exactly once

An operation that can fail takes a requestId from the caller and answers it by calling exactly one of WebRtc.deliverDescription, WebRtc.deliverTracks or WebRtc.deliverResult. A request that never answers leaves an AsyncResource that never settles, which is worse than one that fails. Unsolicited events – a gathered candidate, a state change, a remote track – carry the peer handle instead. Every entry point may be called from any thread; they marshal to the EDT themselves.