Interface IRemoteAudioTrack

RemoteAudioTrack is the basic interface for the remote audio track.

You can get create a remote audio track by the [AgoraRTCRemoteUser.audioTrack]audioTrack object after calling [subscribe]subscribe.

Hierarchy

Properties

isPlaying: boolean

Whether a media track is playing on the webpage:

  • true: The media track is playing on the webpage.
  • false: The media track is not playing on the webpage.
trackMediaType: "audio" | "video"

The type of a media track:

  • "audio": Audio track.
  • "video": Video track.

Methods

  • Gets all the listeners for a specified event.

    Parameters

    • event: string

      The event name.

    Returns Function[]

  • Gets the ID of a media track, a unique identifier generated by the SDK.

    Returns

    The media track ID.

    Returns string

  • Gets the uid of the remote user who publishes the remote track.

    Returns

    The uid of the remote user.

    Returns UID

  • Gets the audio level of a remote audio track.

    Returns

    The audio level. The value range is [0,1]. 1 is the highest audio level.

    Returns number

  • Removes the listener for a specified event.

    Parameters

    • event: string

      The event name.

    • listener: Function

      The callback that corresponds to the event listener.

    Returns void

  • Listens for a specified event.

    When the specified event happens, the SDK triggers the callback that you pass.

    Parameters

    • event: "first-frame-decoded"

      The event name.

    • listener: (() => void)

      The callback to trigger.

        • (): void
        • Occurs when the first remote audio or video frame is decoded.

          As Member Of

          IRemoteTrack

          Group

          Events

          Returns void

    Returns void

  • Listens for a specified event once.

    When the specified event happens, the SDK triggers the callback that you pass and then removes the listener.

    Parameters

    • event: string

      The event name.

    • listener: Function

      The callback to trigger.

    Returns void

  • Plays a remote audio track.

    When playing the audio track, you do not need to pass any DOM element.

    Returns void

  • Removes all listeners for a specified event.

    Parameters

    • Optional event: string

      The event name. If left empty, all listeners for all events are removed.

    Returns void

  • Sets the callback for getting raw audio data in PCM format.

    After you successfully set the callback, the SDK constantly returns the audio frames of a remote audio track in this callback by using AudioBuffer.

    You can set the frameSize parameter to determine the frame size in each callback, which affects the interval between the callbacks. The larger the frame size, the longer the interval between them.

    track.setAudioFrameCallback((buffer) => {
    for (let channel = 0; channel < buffer.numberOfChannels; channel += 1) {
    // Float32Array with PCM data
    const currentChannelData = buffer.getChannelData(channel);
    console.log("PCM data in channel", channel, currentChannelData);
    }
    }, 2048);

    // ....
    // Stop getting the raw audio data
    track.setAudioFrameCallback(null);

    Parameters

    • audioFrameCallback: null | ((buffer: AudioBuffer) => void)

      The callback function for receiving the AudioBuffer object. If you set audioBufferCallback as null, the SDK stops getting raw audio data.

    • Optional frameSize: number

      The number of samples of each audio channel that an AudioBuffer object contains. You can set frameSize as 256, 512, 1024, 2048, 4096, 8192, or 16384. The default value is 4096.

    Returns void

  • Since
       4.1.0

    Sets the audio playback device, for example, the speaker.

    This method supports Chrome only. Other browsers throw a 'NOT_SUPPORTED error when calling this method.

    Parameters

    • deviceId: string

      Device ID, which can be retrieved by calling getPlaybackDevices.

    Returns Promise<void>

  • Sets the volume of a remote audio track.

    Parameters

    • volume: number

      The volume. The value ranges from 0 (mute) to 100 (maximum). A value of 100 is the current volume.

    Returns void

  • Stops playing the media track.

    Returns void

Generated using TypeDoc