IVSReplayKitBroadcastSession

Objective-C


@interface IVSReplayKitBroadcastSession : NSObject

Swift

class IVSReplayKitBroadcastSession : NSObject

This is a streamlined version of an IVSBroadcastSession to be used in a Broadcast Upload Extension. The extensions are under strict memory constraints, and this class removes some of the SDK features in exchange for a reduction in memory footprint.

For example, there are no attach or detach APIs. There are 3 devices created for you, corresponding to the screen, app audio, and the microphone. Pass CMSampleBuffers to these devices from your RPBroadcastSampleHandler implementation. In addition, there is no mixer configuration and no access to an IVSMixer. This class does not support multiple image layers, and the primary layer (the device screen) is always sized to the full output stream scaled to fit. Transparency is also disabled regardless of what is provided in the video configuration.

Finally, you can not create a preview for the systemImageSource or the session as a whole, they will not render anything.

Note

this will automatically set IVSBroadcastSession.applicationAudioSessionStrategy to noAction.

-init
Unavailable

Do not create instances of this class directly
Declaration
Objective-C

IVS_INIT_UNAVAILABLE
+new
Unavailable

Do not create instances of this class directly
Declaration
Objective-C

IVS_INIT_UNAVAILABLE
systemImageSource
A device that is meant to be associated with the video samples in your RPBroadcastSampleHandler implementation.
Declaration
Objective-C

@property (nonatomic, readonly) id<IVSCustomImageSource> _Nonnull systemImageSource;
systemAudioSource
A device that is meant to be associated with the audioApp samples in your RPBroadcastSampleHandler implementation.
Declaration
Objective-C

@property (nonatomic, readonly) id<IVSCustomAudioSource> _Nonnull systemAudioSource;
microphoneSource
A device that is meant to be associated with the audioMic samples in your RPBroadcastSampleHandler implementation.
Declaration
Objective-C

@property (nonatomic, readonly) id<IVSCustomAudioSource> _Nonnull microphoneSource;


                    
                    
                    -initVideoConfiguration:audioConfig:delegate:error:

Creates an instance of IVSReplayKitBroadcastSession.

Declaration

Objective-C

- (nullable instancetype)
    initVideoConfiguration:(nonnull IVSVideoConfiguration *)videoConfig
               audioConfig:(nonnull IVSAudioConfiguration *)audioConfig
                  delegate:(nullable id<IVSBroadcastSessionDelegate>)delegate
                     error:(NSError *_Nullable *_Nullable)outError;

Parameters

`videoConfig`	the video configuration for the output stream.
`audioConfig`	the audio configuration for the output stream.
`delegate`	an `IVSBroadcastSessionDelegate` to receive callbacks from the broadcast session.
`outError`	On input, a pointer to an error object. If an error occurs, the pointer is an NSError object that describes the error. If you don’t want error information, pass in nil.


                    
                    
                    -initVideoConfiguration:audioConfig:reconnectConfig:delegate:error:

Creates an instance of IVSReplayKitBroadcastSession.

Note

On ReplayKit streams when using auto-reconnect the system will still show as broadcasting when attempting to reconnect because the screen is still being captured and the ReplayKit process is still alive. It is recommended that host applications find a way to communicate this to their users.

Declaration

Objective-C

- (nullable instancetype)
    initVideoConfiguration:(nonnull IVSVideoConfiguration *)videoConfig
               audioConfig:(nonnull IVSAudioConfiguration *)audioConfig
           reconnectConfig:(nullable IVSBroadcastAutoReconnectConfiguration *)
                               reconnectConfig
                  delegate:(nullable id<IVSBroadcastSessionDelegate>)delegate
                     error:(NSError *_Nullable *_Nullable)outError;

Parameters

`videoConfig`	the video configuration for the output stream.
`audioConfig`	the audio configuration for the output stream.
`reconnectConfig`	the auto-reconnect configuration.
`delegate`	an `IVSBroadcastSessionDelegate` to receive callbacks from the broadcast session.
`outError`	On input, a pointer to an error object. If an error occurs, the pointer is an NSError object that describes the error. If you don’t want error information, pass in nil.


                    
                    
                    -startWithURL:streamKey:error:

Start the configured broadcast session.

Declaration

Objective-C

- (BOOL)startWithURL:(nonnull NSURL *)url
           streamKey:(nonnull NSString *)streamKey
               error:(NSError *_Nullable *_Nullable)outError;

Swift

func start(with url: URL, streamKey: String) throws

Parameters

`url`	the RTMPS endpoint provided by IVS.
`streamKey`	the broadcaster’s stream key that has been provided by IVS.
`outError`	A reference to an NSError that would be set if an error occurs.

Return Value

if the operation is successful. If it returns NO check isReady.

-stop
Stop the broadcast session, but do not deallocate resources. If this is being called as a result of the ReplayKit broadcast finishing (not just pausing), call broadcastFinished as well to block until the stream properly shuts down. Otherwise iOS may kill the process before the stop call completes, leaving the channel live until it times out.
Declaration
Objective-C

- (void)stop;
Swift

func stop()
-broadcastFinished
Teardown the underlying session, freeing up resources and synchronously forcing a call to stop to complete. Due to the way RPBroadcastSampleHandler handles deallocation, it is strongly recommended you invoke this in the broadcastFinished callback. Once invoked, this all methods on this instance will either no-op, or return an error.
Declaration
Objective-C

- (void)broadcastFinished;
Swift

func broadcastFinished()


                    
                    
                    -sendTimedMetadata:error:

Send timed metadata that will be automatically synchronized with the ongoing stream.

Declaration

Objective-C

- (BOOL)sendTimedMetadata:(nonnull NSString *)contents
                    error:(NSError *_Nullable *_Nullable)outError;

Swift

func sendTimedMetadata(_ contents: String) throws

Parameters


                                contents

text-based metadata that will be interpreted by your receiver.

Return Value

YES if the operation is successful. If it returns NO then an error has occurred.