Cloud Proxy - iOS

Our SDK features a Cloud Proxy that allows you to manage how your streaming content is routed through different network paths. This feature ensures compliance with various regional internet regulations by restricting traffic to specified proxy servers, based on your needs and the geographical location of users.

This capability is crucial for adhering to local data protection laws and optimizes the streaming experience by overcoming geographical network constraints. By directing user connections to appropriate regional servers, Cloud Proxy enhances overall service performance and reliability.

Cloud Proxy offers three straightforward operating modes to fit different business and firewall requirements:

• UDP_OVER_TCP (Default): In this mode, the connection starts by attempting to establish a UDP connection for media transmission. If that fails, it will automatically shifts to a secure TCP connection, which is compatible with most firewalls.

• Force UDP: This mode uses only UDP to send media, ensuring high-quality streams. It's ideal for environments where media quality is critical and the firewall can be configured accordingly.

• Force TCP: Only uses TCP for secure media transmission, suitable for strict firewall settings that only permit TCP traffic over centain ports. This might require additional firewall configuration and could affect media quality under poor network conditions.

In this sequence diagram:

• Client to Proxy Server: The client sends a request to the proxy server, which processes and forwards it based on predefined rules.
• Proxy Server to Destination Server: The proxy server sends the request to the destination server, receives the response, and relays it back to the client.

info

Cloud Proxy is only available under Enteprise Plan, Contact Sales for more information.

Implementation

Pass preferredProtocol and signalingBaseUrl to createRoom(). createRoom() throws ERROR_INVALID_PARAMETER when roomId or token is empty, so call it with try.

var room: Room?

do {
    room = try VideoSDK.createRoom(
        roomId: "abcd-efgh-hijk",
        token: "<YOUR_TOKEN>",
        participantName: "Ted Doe", //optional
        micEnabled: true,
        camEnabled: true,
        participantId: "TD", //optional
        mode: .SEND_AND_RECV, //optional (default mode is SEND_AND_RECV)
        signalingBaseUrl: "proxy.yourwebsite.com", //optional
        preferredProtocol: .UDP_ONLY //optional (default is .UDP_OVER_TCP)
    )
} catch {
    print("Failed to create the room: \(error)")
}

Parameters

• preferredProtocol:
  • UDP_OVER_TCP (default): The connection tries UDP first for media. If that fails, it switches to TCP.
  • UDP_ONLY: Force UDP protocol
  • TCP_ONLY: Force TCP protocol
• signalingBaseUrl: Proxy URL to route signaling and media through. Pass it without https://, for example proxy.yourwebsite.com.

API Reference

The API references for all the methods and events utilized in this guide are provided below.

• createRoom()
• Room