mirror of
https://github.com/mollyim/webrtc.git
synced 2025-05-13 22:00:47 +01:00
e8d5724cc5
A new version of RTC_EXPORT will be introduced by [1] and it will be used by WebRTC native code. This CL renames the current RTC_EXPORT to RTC_OBJC_EXPORT in order to avoid to mix them. It has been decided to avoid to unify them because RTC_OBJC_EXPORT always marks symbols with default visibility, while RTC_EXPORT will do it only when COMPONENT_BUILD is defined. [1] - https://webrtc-review.googlesource.com/c/src/+/97960 is Bug: webrtc:9419 Change-Id: I56a3fc6601c72d3ad6a58f9961a00e3761dfb5da Reviewed-on: https://webrtc-review.googlesource.com/100521 Reviewed-by: Karl Wiberg <kwiberg@webrtc.org> Reviewed-by: Anders Carlsson <andersc@webrtc.org> Commit-Queue: Mirko Bonadei <mbonadei@webrtc.org> Cr-Commit-Position: refs/heads/master@{#24754}
82 lines
2.5 KiB
Objective-C
82 lines
2.5 KiB
Objective-C
/*
|
|
* Copyright 2016 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"
|
|
#import "RTCMediaStreamTrack.h"
|
|
#import "RTCRtpParameters.h"
|
|
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
|
|
/** Represents the media type of the RtpReceiver. */
|
|
typedef NS_ENUM(NSInteger, RTCRtpMediaType) {
|
|
RTCRtpMediaTypeAudio,
|
|
RTCRtpMediaTypeVideo,
|
|
RTCRtpMediaTypeData,
|
|
};
|
|
|
|
@class RTCRtpReceiver;
|
|
|
|
RTC_OBJC_EXPORT
|
|
@protocol RTCRtpReceiverDelegate <NSObject>
|
|
|
|
/** Called when the first RTP packet is received.
|
|
*
|
|
* Note: Currently if there are multiple RtpReceivers of the same media type,
|
|
* they will all call OnFirstPacketReceived at once.
|
|
*
|
|
* For example, if we create three audio receivers, A/B/C, they will listen to
|
|
* the same signal from the underneath network layer. Whenever the first audio packet
|
|
* is received, the underneath signal will be fired. All the receivers A/B/C will be
|
|
* notified and the callback of the receiver's delegate will be called.
|
|
*
|
|
* The process is the same for video receivers.
|
|
*/
|
|
- (void)rtpReceiver:(RTCRtpReceiver *)rtpReceiver
|
|
didReceiveFirstPacketForMediaType:(RTCRtpMediaType)mediaType;
|
|
|
|
@end
|
|
|
|
RTC_OBJC_EXPORT
|
|
@protocol RTCRtpReceiver <NSObject>
|
|
|
|
/** A unique identifier for this receiver. */
|
|
@property(nonatomic, readonly) NSString *receiverId;
|
|
|
|
/** The currently active RTCRtpParameters, as defined in
|
|
* https://www.w3.org/TR/webrtc/#idl-def-RTCRtpParameters.
|
|
*
|
|
* The WebRTC specification only defines RTCRtpParameters in terms of senders,
|
|
* but this API also applies them to receivers, similar to ORTC:
|
|
* http://ortc.org/wp-content/uploads/2016/03/ortc.html#rtcrtpparameters*.
|
|
*/
|
|
@property(nonatomic, readonly) RTCRtpParameters *parameters;
|
|
|
|
/** The RTCMediaStreamTrack associated with the receiver.
|
|
* Note: reading this property returns a new instance of
|
|
* RTCMediaStreamTrack. Use isEqual: instead of == to compare
|
|
* RTCMediaStreamTrack instances.
|
|
*/
|
|
@property(nonatomic, readonly, nullable) RTCMediaStreamTrack *track;
|
|
|
|
/** The delegate for this RtpReceiver. */
|
|
@property(nonatomic, weak) id<RTCRtpReceiverDelegate> delegate;
|
|
|
|
@end
|
|
|
|
RTC_OBJC_EXPORT
|
|
@interface RTCRtpReceiver : NSObject <RTCRtpReceiver>
|
|
|
|
- (instancetype)init NS_UNAVAILABLE;
|
|
|
|
@end
|
|
|
|
NS_ASSUME_NONNULL_END
|