Class SPXPullAudioInputStream

  • Article

Declaration

@class SPXPullAudioInputStream : SPXAudioInputStream;

Description

Represents an audio input stream used for custom audio input configurations.

Methods

initWithReadHandler:closeHandler:

Initializes an SPXPullAudioInputStream that delegates to the specified callback interface for read() and close() methods, using the default format (16 kHz, 16 bit, mono PCM).

- (instancetype _Nullable)initWithReadHandler:(SPXPullAudioInputStreamReadHandler _Nonnull)readHandler
    closeHandler:(SPXPullAudioInputStreamCloseHandler _Nonnull)closeHandler

Parameters

  • readHandler - handler which will be called in order to read data from the audio input stream. If no data is currently available in the stream, the readHandler should wait until data is available. It returns the number of bytes that have been read. It returns 0 when the stream should be closed. The data returned by read() should not contain any audio header.
  • closeHandler - handler which will be called in order to close the audio input stream.

Returns

an instance of pull audio input stream.

initWithAudioFormat:readHandler:closeHandler:

Initializes an SPXPullAudioInputStream that delegates to the specified callback functions for read() and close() methods, with the specified audio format.

- (instancetype _Nullable)initWithAudioFormat:(SPXAudioStreamFormat * _Nonnull)format
    readHandler:(SPXPullAudioInputStreamReadHandler _Nonnull)readHandler
    closeHandler:(SPXPullAudioInputStreamCloseHandler _Nonnull)closeHandler

Parameters

  • format - The audio data format in which audio will be written to the push audio stream's write() method.
  • readHandler - handler which will be called in order to read data from the audio input stream. If no data is currently available in the stream, the readHandler should wait until data is available. It returns the number of bytes that have been read. It returns 0 when stream should be closed. The data returned by read() should not contain any audio header.
  • closeHandler - handler which will be called in order to close the audio input stream.

Returns

The audio input stream being created.

initWithReadHandler:getPropertyHandler:closeHandler:

Initializes an SPXPullAudioInputStream that delegates to the specified callback interface for read() and close() methods, using the default format (16 kHz, 16 bit, mono PCM).

- (instancetype _Nullable)initWithReadHandler:(SPXPullAudioInputStreamReadHandler _Nonnull)readHandler
    getPropertyHandler:(SPXPullAudioInputStreamGetPropertyHandler _Nonnull)getPropertyHandler
    closeHandler:(SPXPullAudioInputStreamCloseHandler _Nonnull)closeHandler

Parameters

  • readHandler - handler which will be called in order to read data from the audio input stream. If no data is currently available in the stream, the readHandler should wait until data is available. It returns the number of bytes that have been read. It returns 0 when the stream should be closed. The data returned by read() should not contain any audio header.
  • getPropertyHandler - handler which will be called in order to get string information associated to given SPXPropertyId.
  • closeHandler - handler which will be called in order to close the audio input stream.

Returns

an instance of pull audio input stream.

initWithAudioFormat:readHandler:getPropertyHandler:closeHandler:

Initializes an SPXPullAudioInputStream that delegates to the specified callback functions for read() and close() methods, with the specified audio format.

- (instancetype _Nullable)initWithAudioFormat:(SPXAudioStreamFormat * _Nonnull)format
    readHandler:(SPXPullAudioInputStreamReadHandler _Nonnull)readHandler
    getPropertyHandler:(SPXPullAudioInputStreamGetPropertyHandler _Nonnull)getPropertyHandler
    closeHandler:(SPXPullAudioInputStreamCloseHandler _Nonnull)closeHandler

Parameters

  • format - The audio data format in which audio will be written to the push audio stream's write() method.
  • readHandler - handler which will be called in order to read data from the audio input stream. If no data is currently available in the stream, the readHandler should wait until data is available. It returns the number of bytes that have been read. It returns 0 when stream should be closed. The data returned by read() should not contain any audio header.
  • getPropertyHandler - handler which will be called in order to get string information associated to given SPXPropertyId.
  • closeHandler - handler which will be called in order to close the audio input stream.

Returns

The audio input stream being created.