xref: /aosp_15_r20/external/webrtc/pc/ice_server_parsing.h (revision d9f758449e529ab9291ac668be2861e7a55c2422)
1 /*
2  *  Copyright 2017 The WebRTC project authors. All Rights Reserved.
3  *
4  *  Use of this source code is governed by a BSD-style license
5  *  that can be found in the LICENSE file in the root of the source
6  *  tree. An additional intellectual property rights grant can be found
7  *  in the file PATENTS.  All contributing project authors may
8  *  be found in the AUTHORS file in the root of the source tree.
9  */
10 
11 #ifndef PC_ICE_SERVER_PARSING_H_
12 #define PC_ICE_SERVER_PARSING_H_
13 
14 #include <vector>
15 
16 #include "api/peer_connection_interface.h"
17 #include "api/rtc_error.h"
18 #include "p2p/base/port.h"
19 #include "p2p/base/port_allocator.h"
20 #include "rtc_base/system/rtc_export.h"
21 
22 namespace webrtc {
23 
24 // Parses the URLs for each server in `servers` to build `stun_servers` and
25 // `turn_servers`. Can return SYNTAX_ERROR if the URL is malformed, or
26 // INVALID_PARAMETER if a TURN server is missing `username` or `password`.
27 //
28 // Intended to be used to convert/validate the servers passed into a
29 // PeerConnection through RTCConfiguration.
30 RTC_EXPORT RTCError
31 ParseIceServersOrError(const PeerConnectionInterface::IceServers& servers,
32                        cricket::ServerAddresses* stun_servers,
33                        std::vector<cricket::RelayServerConfig>* turn_servers);
34 
35 [[deprecated("use ParseIceServersOrError")]] RTC_EXPORT RTCErrorType
36 ParseIceServers(const PeerConnectionInterface::IceServers& servers,
37                 cricket::ServerAddresses* stun_servers,
38                 std::vector<cricket::RelayServerConfig>* turn_servers);
39 
40 }  // namespace webrtc
41 
42 #endif  // PC_ICE_SERVER_PARSING_H_
43