View PowerPoint Live presentations

In this article, you learn how to implement viewing a PowerPoint Live presentation in Microsoft Teams using the Azure Communication Services Calling SDKs. Attendees who use Azure Communication Services Calling SDKs to join a Microsoft Teams meeting can view PowerPoint Live presentations and interact with reactions and raise hand. The attendee view automatically maintains synchronization with the current slide of the Microsoft Teams presenter.

Prerequisites

• An Azure account with an active subscription. Create an account for free.
• A deployed Communication Services resource. Create a Communication Services resource.
• A user access token to enable the calling client. For more information, see Create and manage access tokens.
• Optional: Complete the quickstart to add voice calling to your application

PowerPoint Live viewing is an extended feature of the core Call API. You first need to import calling Features from the Calling SDK:

import { Features}  from "@azure/communication-calling";

Then you can get the feature API object from the call instance:

const pptLive = call.feature(SDK.Features.PPTLive);

Handle presentation state changes

With the PPTLiveCallFeature API, you can subscribe to the isActiveChanged event to handle changes to the state of a PowerPoint Live presentation on a call. This event is triggered by a presenter in Microsoft Teams and isActive indicates if PowerPoint Live is active in the current call.

pptLive.on('isActiveChanged', pptliveStateChangedHandler);

Start and stop presentation viewing

Add the target element to your HTML when the presentation starts and remove it when the presentation stops.

const pptliveStateChangedHandler = () => {
    if (pptLive.isActive) {
        document.getElementById('pptLiveElement').appendChild(pptLive.target);
    } else {
        const pptLiveElement = document.getElementById('pptLiveElement');
        pptLiveElement.removeChild(pptLiveElement.lastElementChild);
    }
};

Stop handling presentation state changes

Your application can unsubscribe from isActiveChanged to stop listening to presentation events.

pptLive.off('isActiveChanged', pptliveStateChangedHandler);

Key things to know when using PowerPoint Live viewing

• Switching to screen sharing is recommended if any issues are experienced with PowerPoint Live viewing.
• PowerPoint Live is supported in the Web Calling SDK.
• PowerPoint Live is supported for Microsoft Teams Meeting interoperability.
• Microsoft Teams must be used to present PowerPoint Live.

Next steps

• Learn how to manage calls and use screen sharing
• Learn how to manage video
• Learn how to use reactions
• Learn how to use raise hand