Specify Audio and Video Constraints in JavaScript
As you build with Twilio Video, you can customize certain aspects of your Participants' audio and video capture to optimize behavior for your specific use case. For example, you can turn on or off features such as noise suppression, or alter the video's frame rate. Below are examples for specifying audio and video constraints for local tracks.
Audio Constraints
You can customize audio capture by setting audio constraints on a LocalAudioTrack. Note that all the constraints default to true.
const { connect, createLocalAudioTrack, createLocalTracks } = require('twilio-video');
// Option 1
createLocalTracks({
audio: { noiseSuppression: false, echoCancellation: false },
video: true
}).then(localTracks => {
return connect('$TOKEN', {
name: 'my-room-name',
tracks: localTracks
});
}).then(room => {
console.log(`Connected to Room: ${room.name}`);
});
// Option 2
connect('$TOKEN', {
audio: { noiseSuppression: false, echoCancellation: false },
name: 'my-room-name',
video: true
}).then(room => {
console.log(`Connected to Room: ${room.name}`);
});
// Option 3
createLocalAudioTrack({
noiseSuppression: false,
echoCancellation: false
}).then(localTrack => {
console.log(`Created LocalAudioTrack: ${localTrack.name}`);
});
Video Constraints
You can customize video capture by setting video constraints on a LocalVideoTrack. Setting constraints lets you optimize the video track for network and device conditions. You can set the size, frame rate, or aspect ratio constraints of your choice. Note that all the constraints default to true.
Please keep in mind that video constraints are used to resolve the video capture format, but the actual video sent to other Participants may be downscaled temporally or spatially in response to those Participants' network and device conditions.
const { connect, createLocalTracks } = require('twilio-video');
// Option 1
createLocalTracks({
audio: true,
video: { width: 640 },
}).then(localTracks => {
return connect('$TOKEN', {
name: 'my-room-name',
tracks: localTracks,
});
}).then(room => {
console.log(`Connected to Room: ${room.name}`);
});
// Option 2
connect('$TOKEN', {
audio: true,
name: 'my-room-name',
video: { width: 640 },
}).then(room => {
console.log(`Connected to Room: ${room.name}`);
});
Need some help?
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.
