Configuring Audio, Video Input and Output devices - Android
This page is for reference only. We are no longer onboarding new customers to Programmable Video. Existing customers can continue to use the product until December 5, 2024.
We recommend migrating your application to the API provided by our preferred video partner, Zoom. We've prepared this migration guide to assist you in minimizing any service disruption.
In this guide we’ll show you how to configure Audio, Video input and output devices from your Twilio Video Rooms API application. Taking advantage of the ability to control input and output devices lets you build a better end user experience.
Selecting a specific Video Input
CameraCapturer
The CameraCapturer provides video frames via the Camera API for a LocalVideoTrack from a given CameraCapturer.CameraSource.
// Share your camera
CameraCapturer cameraCapturer = new CameraCapturer(context, CameraSource.FRONT_CAMERA);
LocalVideoTrack localVideoTrack = LocalVideoTrack.create(context, true, cameraCapturer);
VideoView primaryVideoView = (VideoView) findViewById(R.id.local_video);
// Mirror front camera
primaryVideoView.setMirror(true);
// Render camera to view
localVideoTrack.addSink(primaryVideoView);
// Switch the camera source
CameraSource cameraSource = cameraCapturer.getCameraSource();
cameraCapturer.switchCamera();
primaryVideoView.setMirror(cameraSource == CameraSource.BACK_CAMERA);
Camera2Capturer
The Camera2Capturer provides video frames via the Camera 2 API for a LocalVideoTrack from a given camera ID.
// Get the device camera IDs
CameraManager cameraManager =
(CameraManager) cameraCapturerActivity.getSystemService(Context.CAMERA_SERVICE);
String[] cameraIds = cameraManager.getCameraIdList();
// This example uses the first Camera ID but applications can make their own decisions
// about which Camera ID to use
String cameraId = cameraIds[0];
// Share your camera
Camera2Capturer camera2Capturer = new Camera2Capturer(context, cameraId, camera2Listener);
LocalVideoTrack localVideoTrack = LocalVideoTrack.create(context, true, camera2Capturer);
// Render camera to a view
VideoView primaryVideoView = (VideoView) findViewById(R.id.local_video);
localVideoTrack.addSink(primaryVideoView);
// Switch the camera source from the first camera ID to the second camera ID
camera2Capturer.switchCamera(cameraIds[1]);
For more details and other best practices capturing video from the camera capturers, please reference the Video Android Quickstart.
Managing Audio With AudioSwitch
The Twilio Video Android SDK does not officially support audio device management. Please use AudioSwitch to manage audio focus and audio devices in your application.
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.
