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.The type of a media track:
"audio": Audio track."video": Video track.Adds a reference track to the current audio extension pipeline.
The local or remote audio track used as the reference input.
Closes a local track and releases the audio and video resources that it occupies.
Once you close a local track, you can no longer reuse it.
Gets all the listeners for a specified event.
The event name.
Gets an MediaStreamTrack object.
An MediaStreamTrack object.
Gets the RTCRtpTransceiver instance of the current track.
This method is currently mainly used for end-to-end encryption of video streams (Beta).
If the SDK experiences a reconnection, the
RTCRtpTransceiverinstance corresponding to the current track might change. You can obtain the newRTCRtpTransceiverinstance through the following callbacks:
- For a local track: ILocalTrack.transceiver-updated
- For a remote track: IRemoteTrack.transceiver-updated
The type of the video stream. See StreamType.
The RTCRtpTransceiver instance of the current track.
Gets the statistics of a local audio track.
Gets the ID of a media track, a unique identifier generated by the SDK.
The media track ID.
Gets the label of a local track.
The label that the SDK returns may include:
createMicrophoneAudioTrack or createCameraVideoTrack.sourceId property, if the track is created by calling createScreenVideoTrack.createCustomAudioTrack or createCustomVideoTrack.Gets the audio level of a local audio track.
The audio level. The value range is [0,1]. 1 is the highest audio level. Usually a user with audio level above 0.6 is a speaking user.
Gets the volume level of each original channel in the local audio track.
Levels are measured before channel selection and mixing. If multichannel processing is not enabled, returns an array containing only the result of getVolumeLevel.
The zero-based channel indices to query. If omitted, queries all channels.
An array of volume levels, normally in the range [0, 1], where 0 indicates silence.
Array indices correspond to original channel indices; when channels is specified, unqueried positions are empty.
Before audio data is available, the array or its positions can be empty.
Removes the listener for a specified event.
The event name.
The callback that corresponds to the event listener.
The event name.
See track-updated.
The event name.
See track-ended.
Adds an event listener.
The event name.
Listens for a specified event once.
When the specified event happens, the SDK triggers the callback that you pass and then removes the listener.
The event name.
The callback to trigger.
Inserts a Processor to the local audio track.
The Processor instance. Each extension has a corresponding type of Processor.
The Processor instance.
Plays a local audio track.
When playing a audio track, you do not need to pass any DOM element.
Removes all listeners for a specified event.
The event name. If left empty, all listeners for all events are removed.
Removes an audio extension from the local audio track.
The audio extension instance.
Whether the removal succeeded.
Removes a reference track from the current audio extension pipeline.
The reference input track to remove.
Whether the removal succeeded.
Selects the channels to use from a multichannel audio track and sets the rendering mode.
Applies to multichannel audio tracks created or received with ClientConfig.multiopus enabled. If multichannel processing is not enabled, this method leaves the track unchanged.
The channel indices to use, starting at 0 and less than the original channel count.
The rendering mode. Pass "surround" to preserve the original channel layout. See AudioRenderMode.
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 local audio track in this callback by using AudioBuffer.
You can set the
frameSizeparameter 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);
The callback function for receiving the AudioBuffer object. If you set audioBufferCallback as null, the SDK stops getting raw audio data.
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.
Sets the device for sampling audio.
You can call the method either before or after publishing an audio track.
The ID of the specified device. You can get the deviceId by calling AgoraRTC.getMicrophones.
Whether to enable the track:
true: Enable the track.false: Disable the track.Sends or stops sending the media data of the track.
Whether to stop sending the media data of the track:
true: Stop sending the media data of the track.false: Resume sending the media data of the track.The device ID, which can be retrieved by calling getPlaybackDevices.
Sets the volume of a local audio track.
The volume. The value ranges from 0 (mute) to 1000 (maximum). A value of 100 is the original volume。 The volume change may not be obvious to human ear. If local track has been published, setting volume will affect the volume heard by remote users.
Stops playing the media track.
Creates or reuses an audio extension instance on the current audio track using a class constructor.
The audio extension class constructor.
Optional extension initialization parameters.
Inherited from LocalAudioTrack,
MicrophoneAudioTrackis an interface for the audio sampled by a local microphone and adds several functions such as switching devices.You can create a local microphone audio track by calling AgoraRTC.createMicrophoneAudioTrack.