Digging Deeper - PCast™ Express

1const pcastExpressOptions = {
2    authToken: token,
3};
4var pcastExpress = new sdk.express.PCastExpress(pcastExpressOptions);

1var pcastExpress = roomExpress.getPCastExpress();

1var options = {
2  publishToken: 'DIGEST:...',
3  mediaConstraints: { audio: true, video: true },
4  videoElement: document.querySelector('#myVideoId'),
5};
6
7pcastExpress.publish(options, function callback(error, response) {
8  if (error) {
9    // Handle error
10  }
11
12  if (response.status !== 'ok') {
13    // Handle error
14  }
15
16  // Successfully published
17  if (response.status === 'ok' && response.publisher) {
18    // Do something with publisher
19  }
20});

1var options = {
2  publishToken: 'DIGEST:...',
3  streamUri: 'https://routeToMyVideo/video.mp4',
4  videoElement: document.querySelector('#myVideoId'),
5};
6
7pcastExpress.publishRemote(options, function callback(error, response) {
8  if (error) {
9    // Handle error
10  }
11
12  if (response.status !== 'ok') {
13    // Handle error
14  }
15
16  // Successfully published
17  if (response.status === 'ok' && response.publisher) {
18    // Do something with publisher
19  }
20});

1var options = {
2  streamId: publisher.getStreamId(),
3  publishToken: 'DIGEST:...',
4  videoElement: document.querySelector('#myVideoId'),
5};
6
7pcastExpress.subscribe(options, function callback(error, response) {
8  if (error) {
9    // Handle error
10  }
11
12  if (response.status !== 'ok') {
13    // Handle error
14  }
15
16  // Successfully subscribed
17  if (response.status === 'ok' && response.mediaStream) {
18    // Do something with mediaStream
19
20    if (response.renderer) {
21      // Returned if videoElement option passed in - Do something with renderer
22
23      response.renderer.on('autoMuted', function handleAutoMuted() {
24        // The browser refused to play video with audio therefore the stream was started muted.
25        // Handle this case properly in your UI so that the user can unmute its stream
26      });
27
28      response.renderer.on('failedToPlay', function handleEnded(reason) {
29        if (reason === 'failed-to-play') {
30          // Failed to play media stream
31        }
32        if (reason === 'failed-to-play-unmuted') {
33          // Failed to play media stream given the auto mute was disabled
34        }
35        if (reason === 'paused-by-background') {
36          // Unable to resume playback after pause in Safari
37        }
38      });
39    }
40  }
41});

1var monitorOptions = {
2  options: {
3    // Optional: Additional options for monitoring a stream
4
5    conditionCountForNotificationThreshold: 4,
6    // Number of conditions before triggering callback
7  },
8
9  callback: function monitorCallback(error, response) {
10    // Optional: Handle monitor event
11
12    if (error) {
13      // Handle error
14    }
15
16    if (response.retry) {
17      response.retry();
18      // Re-connects publisher or subscriber stream
19    }
20  },
21};

1var options = {
2  mediaConstraints: { audio: true, video: true },
3  resolution: 1080,
4  frameRate: 30,
5  aspectRatio: '4x3',
6};
7
8pcastExpress.getUserMedia(options, function callback(error, response) {
9  if (error) {
10    // Handle error
11  }
12
13  if (response.status !== 'ok') {
14    // Handle error
15  }
16
17  // Successfully got user media
18  if (response.status === 'ok' && response.userMedia) {
19    // Do something with userMedia
20  }
21});

1var pcast = pcastExpress.getPCast();

1var pcastExpress = pcastExpress.dispose();