mirror of
https://github.com/mollyim/webrtc.git
synced 2025-05-13 22:00:47 +01:00
a81e9c82fc
This CL introduced 2 new macros that affect the WebRTC OBJC API symbols: - RTC_OBJC_TYPE_PREFIX: Macro used to prepend a prefix to the API types that are exported with RTC_OBJC_EXPORT. Clients can patch the definition of this macro locally and build WebRTC.framework with their own prefix in case symbol clashing is a problem. This macro must only be defined by changing the value in sdk/objc/base/RTCMacros.h and not on via compiler flag to ensure it has a unique value. - RCT_OBJC_TYPE: Macro used internally to reference API types. Declaring an API type without using this macro will not include the declared type in the set of types that will be affected by the configurable RTC_OBJC_TYPE_PREFIX. Manual changes: https://webrtc-review.googlesource.com/c/src/+/173781/5..10 The auto-generated changes in PS#5 have been done with: https://webrtc-review.googlesource.com/c/src/+/174061. Bug: None Change-Id: I0d54ca94db764fb3b6cb4365873f79e14cd879b8 Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/173781 Commit-Queue: Mirko Bonadei <mbonadei@webrtc.org> Reviewed-by: Karl Wiberg <kwiberg@webrtc.org> Reviewed-by: Kári Helgason <kthelgason@webrtc.org> Cr-Commit-Position: refs/heads/master@{#31153}
114 lines
4.5 KiB
Objective-C
114 lines
4.5 KiB
Objective-C
/*
|
|
* Copyright 2015 The WebRTC project authors. All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by a BSD-style license
|
|
* that can be found in the LICENSE file in the root of the source
|
|
* tree. An additional intellectual property rights grant can be found
|
|
* in the file PATENTS. All contributing project authors may
|
|
* be found in the AUTHORS file in the root of the source tree.
|
|
*/
|
|
|
|
#import <Foundation/Foundation.h>
|
|
|
|
#import "RTCMacros.h"
|
|
|
|
typedef NS_ENUM(NSUInteger, RTCTlsCertPolicy) {
|
|
RTCTlsCertPolicySecure,
|
|
RTCTlsCertPolicyInsecureNoCheck
|
|
};
|
|
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
|
|
RTC_OBJC_EXPORT
|
|
@interface RTC_OBJC_TYPE (RTCIceServer) : NSObject
|
|
|
|
/** URI(s) for this server represented as NSStrings. */
|
|
@property(nonatomic, readonly) NSArray<NSString *> *urlStrings;
|
|
|
|
/** Username to use if this RTCIceServer object is a TURN server. */
|
|
@property(nonatomic, readonly, nullable) NSString *username;
|
|
|
|
/** Credential to use if this RTCIceServer object is a TURN server. */
|
|
@property(nonatomic, readonly, nullable) NSString *credential;
|
|
|
|
/**
|
|
* TLS certificate policy to use if this RTCIceServer object is a TURN server.
|
|
*/
|
|
@property(nonatomic, readonly) RTCTlsCertPolicy tlsCertPolicy;
|
|
|
|
/**
|
|
If the URIs in |urls| only contain IP addresses, this field can be used
|
|
to indicate the hostname, which may be necessary for TLS (using the SNI
|
|
extension). If |urls| itself contains the hostname, this isn't necessary.
|
|
*/
|
|
@property(nonatomic, readonly, nullable) NSString *hostname;
|
|
|
|
/** List of protocols to be used in the TLS ALPN extension. */
|
|
@property(nonatomic, readonly) NSArray<NSString *> *tlsAlpnProtocols;
|
|
|
|
/**
|
|
List elliptic curves to be used in the TLS elliptic curves extension.
|
|
Only curve names supported by OpenSSL should be used (eg. "P-256","X25519").
|
|
*/
|
|
@property(nonatomic, readonly) NSArray<NSString *> *tlsEllipticCurves;
|
|
|
|
- (nonnull instancetype)init NS_UNAVAILABLE;
|
|
|
|
/** Convenience initializer for a server with no authentication (e.g. STUN). */
|
|
- (instancetype)initWithURLStrings:(NSArray<NSString *> *)urlStrings;
|
|
|
|
/**
|
|
* Initialize an RTCIceServer with its associated URLs, optional username,
|
|
* optional credential, and credentialType.
|
|
*/
|
|
- (instancetype)initWithURLStrings:(NSArray<NSString *> *)urlStrings
|
|
username:(nullable NSString *)username
|
|
credential:(nullable NSString *)credential;
|
|
|
|
/**
|
|
* Initialize an RTCIceServer with its associated URLs, optional username,
|
|
* optional credential, and TLS cert policy.
|
|
*/
|
|
- (instancetype)initWithURLStrings:(NSArray<NSString *> *)urlStrings
|
|
username:(nullable NSString *)username
|
|
credential:(nullable NSString *)credential
|
|
tlsCertPolicy:(RTCTlsCertPolicy)tlsCertPolicy;
|
|
|
|
/**
|
|
* Initialize an RTCIceServer with its associated URLs, optional username,
|
|
* optional credential, TLS cert policy and hostname.
|
|
*/
|
|
- (instancetype)initWithURLStrings:(NSArray<NSString *> *)urlStrings
|
|
username:(nullable NSString *)username
|
|
credential:(nullable NSString *)credential
|
|
tlsCertPolicy:(RTCTlsCertPolicy)tlsCertPolicy
|
|
hostname:(nullable NSString *)hostname;
|
|
|
|
/**
|
|
* Initialize an RTCIceServer with its associated URLs, optional username,
|
|
* optional credential, TLS cert policy, hostname and ALPN protocols.
|
|
*/
|
|
- (instancetype)initWithURLStrings:(NSArray<NSString *> *)urlStrings
|
|
username:(nullable NSString *)username
|
|
credential:(nullable NSString *)credential
|
|
tlsCertPolicy:(RTCTlsCertPolicy)tlsCertPolicy
|
|
hostname:(nullable NSString *)hostname
|
|
tlsAlpnProtocols:(NSArray<NSString *> *)tlsAlpnProtocols;
|
|
|
|
/**
|
|
* Initialize an RTCIceServer with its associated URLs, optional username,
|
|
* optional credential, TLS cert policy, hostname, ALPN protocols and
|
|
* elliptic curves.
|
|
*/
|
|
- (instancetype)initWithURLStrings:(NSArray<NSString *> *)urlStrings
|
|
username:(nullable NSString *)username
|
|
credential:(nullable NSString *)credential
|
|
tlsCertPolicy:(RTCTlsCertPolicy)tlsCertPolicy
|
|
hostname:(nullable NSString *)hostname
|
|
tlsAlpnProtocols:(nullable NSArray<NSString *> *)tlsAlpnProtocols
|
|
tlsEllipticCurves:(nullable NSArray<NSString *> *)tlsEllipticCurves
|
|
NS_DESIGNATED_INITIALIZER;
|
|
|
|
@end
|
|
|
|
NS_ASSUME_NONNULL_END
|