WebRTC PSA: Migrating cricket and rtc namespaces to webrtc

[es...@webrtc.org]

This Public Service Announcement concerns the migration of all "cricket" and "rtc" namespaces to the "webrtc" namespace. This work is tracked in https://issues.webrtc.org/issues/42232595 and will be executed gradually over the coming months, file by file. All declarations made within the "rtc" or "cricket" namespace will be exported with using declarations.

Please note that 13 symbols (enumerated in the dependencies section of the tracking bug) will necessitate additional work due to name or implementation conflicts; these will be managed independently.

As symbols are exported via "using" declarations, this migration should not result in any service interruptions unless your application utilizes forward declarations with WebRTC. In such cases, you can simply relocate the symbols to the WebRTC namespace once an interruption occurs or transition from using forward declarations to using includes.

Once all declarations have been migrated to the WebRTC namespace, an additional Public Service Announcement will be issued to announce the deprecation and scheduled removal of the "rtc" and "cricket" namespaces.

Please submit a bug report or contact us directly if you have any concerns.

Sincerely,

Evan

[es...@webrtc.org]

Hello again,

The migration to remove the "cricket" and "rtc" namespaces is complete. The WEBRTC_ALLOW_DEPRECATED_NAMESPACES define temporarily guards the re-exporting of named declarations from the webrtc namespace to their previous namespaces.

We will remove this re-exporting of relocated declarations in 3 weeks, on July 1st. To avoid any breaking changes, please update your code to use the "webrtc" namespace instead of "rtc" or "cricket".

During these changes, the following symbol names were changed due to name collisions: 

cricket::RtcpParameters => webrtc::MediaChannelParameters::RtcpParameters
cricket::AudioCodec => webrtc::Codec
cricket::AudioCodecs => webrtc::Codecs
cricket::DtlsTransport => webrtc::DtlsTransportInternalImpl
cricket::IceTransportState => webrtc::IceTransportStateInternal
cricket::VideoCodec => webrtc::Codec
cricket::VideoCodecs => webrtc::Codecs
rtc::PacketOptions => webrtc::AsyncSocketPacketOptions
rtc::ReceivedPacket => webrtc::ReceivedIpPacket
rtc::SentPacket => webrtc::SentPacketInfo

Please submit a bug report or contact us directly if you have any concerns.

Sincerely,
Evan