Join as Listener with Protected Conferences

Affects

Dolby Product(s)

• Interactivity API Web SDK 3.1.x

Description

When using Enhanced Conference Protection, joining as a listener expects the SEND_AUDIO permission. If you only have the JOIN permission for the listeners, you will receive the following error message Failed to join conference InsufficientPermissionsError: Insufficient permissions for this operation

Reproduction Steps

1. Request an access token (through invitation) for the listener
2. Only grant the JOIN permission
3. When the user joins the conference as a listener, the SDK will throw an exception.

Workaround

In your join options, set the contraints audio and video to false.

constraints: {
    audio: false,
    video: false
}

Here is an example for joining as a listener:

/**
 * Joins the specified conference as a listener.
 * @param {string} conferenceId Conference ID.
 * @param {string} conferenceAccessToken Conference Access Token provided by the backend.
 * @return {Promise<void>} A Promise for the completion of the function.
 */
static listenToConference(conferenceId, conferenceAccessToken) {
    // Get the conference object
    return VoxeetSDK.conference.fetch(conferenceId)
        .then((conference) => {
            // See: https://dolby.io/developers/interactivity-apis/reference/client-sdk/reference-javascript/model/listenoptions
            const joinOptions = {
                conferenceAccessToken: conferenceAccessToken,
                constraints: {
                    audio: false,
                    video: false
                },
                maxVideoForwarding: 4
            };

            // Join the conference
            return VoxeetSDK.conference.listen(conference, joinOptions);
        });
}

Action Plan

• Will be fixed in SDK 3.2

Update -7/28/2021

This issue has been resolved with js SDK 3.2.1

Ticket References

Dolby Reference

• CC-1051