package android.emulation.control.v2

Get desktop application:
View/edit binary Protocol Buffers messages

Reported connectivity of client network

(message has no fields)

Used in: IceServerConfig

• STATUS_UNSPECIFIED = 0

  Connectivity status is unspecified.

• NOT_BLOCKED = 1

  Connectivity to ICE servers is unimpaired.

• POSSIBLY_BLOCKED = 2

  Connectivity to ICE servers is possibly blocked.

ICE server configuration. Each configuration is ephemeral and should not be shared across WebRTC peer connections or cached for later use.

• optional google.protobuf.Duration lifetime_duration = 1

  Duration the config is valid for.

• repeated IceServerList ice_servers = 2

  ICE servers to be used by the client to establish a connection. E.g.: [ { "urls": "stun:stun1.example.net" }, { "urls": "turn:turn.example.org", "username": "user", "credential": "myPassword" } ]

• string ice_transport_policy = 6

  Corresponds to: https://www.w3.org/TR/webrtc/#rtcicetransportpolicy-enum The recommended ICE transport policy to use in the RTC configuration.

• BlockStatus.Value block_status = 3

  Possible detected network provider interference with ice_servers connectivity. This is an estimation which might be inaccurate.

• repeated IceServerList unblock_ice_servers = 4

  Extra ice servers that can be present when block_status indicates POSSIBLY_BLOCKED and which might be able to provide better connectivity than ice_servers in that scenario. However the network quality is likely to be strictly worse. Applications are recommended to use these servers instead of ice_servers to be robust against blocking. However these ice servers also currently requires applications to disable TLS validation. This is because TURNS is used for obfuscation instead of security, and no valid certificate is returned since valid certificates can be blocked.

• optional UnblockConfig unblock_config = 7

  Extra optional configuration for unblocking purposes.

ICE Server configuration based on the RTCIceServer type in the WebRTC W3C specification: https://www.w3.org/TR/webrtc/#rtciceserver-dictionary.

Used in: IceServerConfig

• repeated string urls = 1

  STUN or TURN URI(s) as defined in [rfc7064] and [rfc7065] or other URI types.

• string username = 2

  If this IceServer object represents a TURN server, then this attribute specifies the credential to use with that TURN server.

• string credential = 3

  If this IceServer object represents a TURN server, then this attribute specifies the credential to use with that TURN server.

• TlsCertPolicy.Value tls_cert_policy = 4

  The TLS certificate policy to use for TLS urls.

• string hostname = 5

  If the URIs in urls only contain IP addresses, this field can be used to indicate the hostname. If specified, it should be used for TLS SNI and certificate validation for any applicable URLs. For urls that themselves contains the hostname, this can be ignored.

• repeated string tls_alpn_protocols = 6

  List of protocols to be used in the TLS ALPN extension.

• repeated string tls_elliptic_curves = 7

  List of elliptic curves to be used in the TLS elliptic curves extension. Only curves supported by OpenSSL should be used (e.g. "P-256", "X25519").

• StunAltMagicSetting.Type stun_alt_magic = 9

  Setting for STUN alternative magic cookie.

• int64 max_rate_kbps = 10

  Maximum rate in kilobits per second (kilo = 1000). Can be used as hint to the bandwidth estimator to improve media quality. If less than or equal to zero, the maximum send rate is not specified.

Setting for StunAltMagic.

(message has no fields)

Used in: IceServerList

• DEFAULT = 0

  Use default.

• DISABLED = 1

  Use normal stun magic.

• ENABLED = 2

  Use stun alt magic.

TLS certificate policy.

(message has no fields)

Used in: IceServerList

• DEFAULT_SECURE = 0

  For TLS based protocols, ensure the connection is secure by not circumventing certificate validation. This is the default and should be used when unspecified.

• INSECURE_NO_CHECK = 1

  For TLS based protocols, disregard security completely by skipping certificate validation. This is insecure and should never be used unless security is irrelevant in that particular context.

Extra unblocking configuration.

Used in: IceServerConfig

• int32 min_pad_length = 1

  Minimum length to pad STUN messages.

• int32 max_pad_length = 2

  Maximum length to pad STUN messages.

• int32 min_channel_data_payload_size = 3

  The minimum payload size of channel data. Smaller messages should be sent as TURN send indications. Since channel data messages are not easily padded it is useful to avoid sending some smaller messages as channel data.

• bool pad_ice_stun_ping = 4

  Pad ICE STUN ping requests and responses.

• bool enable_padding = 5

  Enable padding.