Getting Started: Twilio Programmable Video with Android

1
allprojects {
2
    repositories {
3
        mavenCentral()
4
    }
5
}
6

7
// The Video library resides on Maven Central
8
implementation 'com.twilio:video-android:7.5.1'
9

10
android {
11
    compileOptions {
12
        sourceCompatibility 1.8
13
        targetCompatibility 1.8
14
    }
15
}

1
-keep class tvi.webrtc.** { *; }
2
-keep class com.twilio.video.** { *; }
3
-keepattributes InnerClasses

1
private Room.Listener roomListener() {
2
  return new Room.Listener() {
3
      @Override
4
      public void onConnected(Room room) {
5
        Log.d(TAG,"Connected to " + room.getName());
6
      }
7
  }
8
}
9

10
public void connectToRoom(String roomName) {
11
  ConnectOptions connectOptions = new ConnectOptions.Builder(accessToken)
12
    .roomName(roomName)
13
    .audioTracks(localAudioTracks)
14
    .videoTracks(localVideoTracks)
15
    .dataTracks(localDataTracks)
16
    .build();
17
  room = Video.connect(context, connectOptions, roomListener);
18
}

1
private Room.Listener roomListener() {
2
  return new Room.Listener() {
3
    @Override
4
    public void onConnected(Room room) {
5
      Log.d(TAG,"Connected to " + room.getName());
6
    }
7
  }
8
}
9

10
public void connectToRoom(String roomName) {
11
  ConnectOptions connectOptions = new ConnectOptions.Builder(accessToken)
12
    .roomName(roomName)
13
    .audioTracks(localAudioTracks)
14
    .videoTracks(localVideoTracks)
15
    .dataTracks(localDataTracks)
16
    .build();
17
  room = Video.connect(context, connectOptions, roomListener);
18
}

1
// Create an audio track
2
boolean enable = true;
3
LocalAudioTrack localAudioTrack = LocalAudioTrack.create(context, enable);
4

5
// A video track requires an implementation of a VideoCapturer. Here's how to use the front camera with a Camera2Capturer.
6
Camera2Enumerator camera2Enumerator = new Camera2Enumerator(context);
7
String frontCameraId = null;
8
for (String cameraId : camera2Enumerator.getDeviceNames()) {
9
    if (camera2Enumerator.isFrontFacing(cameraId)) {
10
        frontCameraId = cameraId;
11
        break;
12
    }
13
}
14
if(frontCameraId != null) {
15
    // Create the CameraCapturer with the front camera
16
    CameraCapturer cameraCapturer = new Camera2Capturer(context, frontCameraId);
17

18
    // Create a video track
19
    LocalVideoTrack localVideoTrack = LocalVideoTrack.create(context, enable, cameraCapturer);
20

21
    // Rendering a local video track requires an implementation of VideoSink
22
    // Let's assume we have added a VideoView in our view hierarchy
23
    VideoView videoView = (VideoView) findViewById(R.id.video_view);
24

25
    // Render a local video track to preview your camera
26
    localVideoTrack.addSink(videoView);
27

28
    // Release the audio track to free native memory resources
29
    localAudioTrack.release();
30

31
    // Release the video track to free native memory resources
32
    localVideoTrack.release();
33
}

1
public void connectToRoom(String roomName) {
2
  ConnectOptions connectOptions = new ConnectOptions.Builder(accessToken)
3
    .roomName("my-room")
4
    .enableAutomaticSubscription(false)
5
    .build();
6
  room = Video.connect(context, connectOptions, roomListener);
7
}

1
// Connect to room
2
Room room = Video.connect(context, connectOptions, new Room.Listener() {
3
    @Override
4
    public void onConnected(Room room) {}
5

6
    @Override
7
    public void onConnectFailure(Room room, TwilioException e) {}
8

9
    @Override
10
    public void onDisconnected(Room room, TwilioException e) {}
11

12
    @Override
13
    public void onRecordingStarted(Room room) {}
14

15
    @Override
16
    public void onRecordingStopped(Room room) {}
17

18
    @Override
19
    public void onParticipantConnected(Room room, RemoteParticipant participant) {
20
        Log.i("Room.Listener", participant.getIdentity() + " has joined the room.");
21
    }
22

23
    @Override
24
    public void onParticipantDisconnected(Room room, RemoteParticipant participant) {
25
        Log.i("Room.Listener", participant.getIdentity() + " has left the room.");
26
    }
27
);
28

29
// ... Assume we have received the connected callback
30

31
// After receiving the connected callback the LocalParticipant becomes available
32
LocalParticipant localParticipant = room.getLocalParticipant();
33
Log.i("LocalParticipant ", localParticipant.getIdentity());
34

35
// Get the first participant from the room
36
RemoteParticipant participant = room.getRemoteParticipants().get(0);
37
Log.i("HandleParticipants", participant.getIdentity() + " is in the room.");
38

1
private Room.Listener roomListener() {
2
  return new Room.Listener() {
3

4
    @Override
5
    public void onParticipantConnected(Room room, RemoteParticipant participant) {
6
      Log.v(TAG, "Participant connected: " + participant.getIdentity());
7
    }
8

9
    @Override
10
    public void onParticipantDisconnected(Room room, RemoteParticipant participant) {
11
      Log.v(TAG, "Participant disconnected: " + participant.getIdentity());
12
    }
13
  };
14
}

1
// First, we set a Media Listener when a Participant first connects:
2
private Room.Listener roomListener() {
3
  return new Room.Listener() {
4
    @Override
5
    public void onParticipantConnected(Room room, RemoteParticipant participant) {
6
      participant.setListener(remoteParticipantListener());
7
    }
8
  };
9
}
10

11
/* In the Participant listener, we can respond when the Participant adds a Video
12
Track by rendering it on screen: */
13
private RemoteParticipant.Listener remoteParticipantListener() {
14
  return new RemoteParticipant.Listener() {
15
      @Override
16
      public void onVideoTrackSubscribed(RemoteParticipant participant,
17
                                         RemoteVideoTrackPublication remoteVideoTrackPublication,
18
                                         RemoteVideoTrack remoteVideoTrack) {
19
        primaryVideoView.setMirror(false);
20
        remoteVideoTrack.addSink(primaryVideoView);
21
      }
22
  };
23
}

1
/* The CameraCapturer is a default video capturer provided by Twilio which can
2
   capture video from the front or rear-facing device camera */
3
private CameraCapturer cameraCapturer;
4

5
/* A VideoView receives frames from a local or remote video track and renders them
6
   to an associated view. */
7
private VideoView primaryVideoView;
8

9
// Start the camera preview
10
LocalVideoTrack localVideoTrack = LocalVideoTrack.create(context, true, cameraCapturer);
11
primaryVideoView.setMirror(true);
12
localVideoTrack.addSink(primaryVideoView);
13

14
// Release the local video track to free native memory resources once you are done
15
localVideoTrack.release();

1
// To disconnect from a Room, we call:
2
room.disconnect();
3

4
// This results in a call to Room.Listener#onDisconnected
5
private Room.Listener roomListener() {
6
  return new Room.Listener() {
7
    @Override
8
    public void onDisconnected(Room room, TwilioException e) {
9
        Log.d(TAG,"Disconnected from " + room.getName());
10
    }
11
  };
12
}

1
private Room.Listener roomListener() {
2
  return new Room.Listener() {
3

4
    /*
5
     * Exception will be either TwilioException.SIGNALING_CONNECTION_DISCONNECTED_EXCEPTION or
6
     * TwilioException.MEDIA_CONNECTION_ERROR_EXCEPTION
7
     */
8
    @Override
9
    public void onReconnecting(Room room, TwilioException exception) {
10
      Log.v(TAG, "Reconnecting to room: " + room.getName() + ", exception = " + exception.getMessage());
11
    }
12

13
    @Override
14
    public void onReconnected(Room room) {
15
      Log.v(TAG, "Reconnected to room " + room.getName());
16
    }
17
  };
18
}

1
/*
2
 * Set the log level of the Video Android SDK
3
 */
4
Video.setLogLevel(LogLevel.DEBUG);
5

6
/*
7
 * If your application is experiencing an issue related to a specific
8
 * module, you can set the log level of each of the following modules.
9
 */
10
Video.setModuleLogLevel(LogModule.CORE, LogLevel.DEBUG);
11
Video.setModuleLogLevel(LogModule.PLATFORM, LogLevel.DEBUG);
12
Video.setModuleLogLevel(LogModule.SIGNALING, LogLevel.DEBUG);
13
Video.setModuleLogLevel(LogModule.WEBRTC, LogLevel.DEBUG);