1 /* 2 * libjingle 3 * Copyright 2013 Google Inc. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions are met: 7 * 8 * 1. Redistributions of source code must retain the above copyright notice, 9 * this list of conditions and the following disclaimer. 10 * 2. Redistributions in binary form must reproduce the above copyright notice, 11 * this list of conditions and the following disclaimer in the documentation 12 * and/or other materials provided with the distribution. 13 * 3. The name of the author may not be used to endorse or promote products 14 * derived from this software without specific prior written permission. 15 * 16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED 17 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 18 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO 19 * EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 20 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 21 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 22 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 23 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR 24 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 25 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 26 */ 27 28 #import <Foundation/Foundation.h> 29 30 @class RTCAudioTrack; 31 @class RTCConfiguration; 32 @class RTCMediaConstraints; 33 @class RTCMediaStream; 34 @class RTCPeerConnection; 35 @class RTCVideoCapturer; 36 @class RTCVideoSource; 37 @class RTCVideoTrack; 38 @protocol RTCPeerConnectionDelegate; 39 40 // RTCPeerConnectionFactory is an ObjectiveC wrapper for PeerConnectionFactory. 41 // It is the main entry point to the PeerConnection API for clients. 42 @interface RTCPeerConnectionFactory : NSObject 43 44 // Initialize & de-initialize the SSL subsystem. Failure is fatal. 45 + (void)initializeSSL; 46 + (void)deinitializeSSL; 47 48 // Create an RTCPeerConnection object. RTCPeerConnectionFactory will create 49 // required libjingle threads, socket and network manager factory classes for 50 // networking. 51 - (RTCPeerConnection *) 52 peerConnectionWithICEServers:(NSArray *)servers 53 constraints:(RTCMediaConstraints *)constraints 54 delegate:(id<RTCPeerConnectionDelegate>)delegate; 55 56 // Creates a peer connection using the default port allocator factory and identity service. 57 - (RTCPeerConnection *)peerConnectionWithConfiguration:(RTCConfiguration *)configuration 58 constraints:(RTCMediaConstraints *)constraints 59 delegate:(id<RTCPeerConnectionDelegate>)delegate; 60 61 // Create an RTCMediaStream named |label|. 62 - (RTCMediaStream *)mediaStreamWithLabel:(NSString *)label; 63 64 // Creates a RTCVideoSource. The new source takes ownership of |capturer|. 65 // |constraints| decides video resolution and frame rate but can be NULL. 66 - (RTCVideoSource *)videoSourceWithCapturer:(RTCVideoCapturer *)capturer 67 constraints:(RTCMediaConstraints *)constraints; 68 69 // Creates a new local VideoTrack. The same |source| can be used in several 70 // tracks. 71 - (RTCVideoTrack *)videoTrackWithID:(NSString *)videoId 72 source:(RTCVideoSource *)source; 73 74 // Creates an new AudioTrack. 75 - (RTCAudioTrack *)audioTrackWithID:(NSString *)audioId; 76 77 @end 78