@microsoft/live-share-media 1.4.0 → 1.4.2

package/bin/esm/LiveMediaSessionCoordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveMediaSessionCoordinator.d.ts","sourceRoot":"","sources":["../../src/LiveMediaSessionCoordinator.ts"],"names":[],"mappings":"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"}

package/bin/esm/LiveMediaSessionCoordinator.js

@@ -0,0 +1,556 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the Microsoft Live Share SDK License.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { LiveTelemetryLogger, LiveDataObjectInitializeState, LiveDataObjectInitializeNotNeededError, LiveDataObjectNotInitializedError, } from "@microsoft/live-share";
+import { LiveEventScope, LiveEventTarget, LiveObjectSynchronizer, isErrorLike, } from "@microsoft/live-share/internal";
+import { GroupCoordinatorState, GroupCoordinatorStateEvents, } from "./internals/GroupCoordinatorState.js";
+import { TelemetryEvents } from "./internals/consts.js";
+import { TrackMetadataNotSetError, ActionBlockedError, } from "./internals/errors.js";
+import { PriorityTimeInterval } from "./internals/PriorityTimeInterval.js";
+import { LiveMediaSessionCoordinatorSuspension } from "./LiveMediaSessionCoordinatorSuspension.js";
+import { TypedEventEmitter } from "@fluid-internal/client-utils";
+/**
+ * The `LiveMediaSessionCoordinator` tracks the playback & position state of all other
+ * clients being synchronized with. It is responsible for keeping the local media player
+ * in sync with the group.
+ */
+export class LiveMediaSessionCoordinator extends TypedEventEmitter {
+    /**
+     * @hidden
+     * Applications shouldn't directly create new coordinator instances.
+     */
+    constructor(id, runtime, liveRuntime, getPlayerState) {
+        super();
+        this._positionUpdateInterval = new PriorityTimeInterval(2000, 
+        // Scale by function
+        () => {
+            const audience = this._liveRuntime.audience;
+            if (!audience)
+                return 1;
+            // As the audience size gets bigger, we relax the update interval, since more variance is expected
+            const count = audience.getMembers().size;
+            return 1 + count / 5;
+        });
+        this._maxPlaybackDrift = new PriorityTimeInterval(1500, // Scale by function
+        () => {
+            const audience = this._liveRuntime.audience;
+            if (!audience)
+                return 1;
+            // As the audience size gets bigger, we relax the playback drift, since more variance is expected
+            const count = audience.getMembers().size;
+            return 1 + count / 25;
+        });
+        this.initializeState = LiveDataObjectInitializeState.needed;
+        /**
+         * Controls whether or not the local client is allowed to instruct the group to play or pause.
+         *
+         * @remarks
+         * This flag largely meant to influence decisions made by the coordinator and can be used by
+         * the UI to determine what controls should be shown to the user. It does not provide any
+         * security in itself.
+         *
+         * If your app is running in a semi-trusted environment where only some clients are allowed
+         * to play/pause media, you should use "role based verification" to enforce those policies.
+         */
+        this.canPlayPause = true;
+        /**
+         * Controls whether or not the local client is allowed to seek the group to a new playback
+         * position.
+         *
+         * @remarks
+         * This flag largely meant to influence decisions made by the coordinator and can be used by
+         * the UI to determine what controls should be shown to the user. It does not provide any
+         * security in itself.
+         *
+         * If your app is running in a semi-trusted environment where only some clients are allowed
+         * to change the playback position, you should use "role based verification" to enforce those policies.
+         */
+        this.canSeek = true;
+        /**
+         * Controls whether or not the local client is allowed to change tracks.
+         *
+         * @remarks
+         * This flag largely meant to influence decisions made by the coordinator and can be used by
+         * the UI to determine what controls should be shown to the user. It does not provide any
+         * security in itself.
+         *
+         * If your app is running in a semi-trusted environment where only some clients are allowed
+         * to change tracks, you should use "role based verification" to enforce those policies.
+         */
+        this.canSetTrack = true;
+        /**
+         * Controls whether or not the local client is allowed to change the tracks custom data object.
+         *
+         * @remarks
+         * This flag largely meant to influence decisions made by the coordinator and can be used by
+         * the UI to determine what controls should be shown to the user. It does not provide any
+         * security in itself.
+         *
+         * If your app is running in a semi-trusted environment where only some clients are allowed
+         * to change the tracks data object, you should use "role based verification" to enforce those
+         * policies.
+         */
+        this.canSetTrackData = true;
+        /**
+         * Controls whether or not the local client is allowed to change the playback rate.
+         *
+         * @remarks
+         * This flag largely meant to influence decisions made by the coordinator and can be used by
+         * the UI to determine what controls should be shown to the user. It does not provide any
+         * security in itself.
+         *
+         * If your app is running in a semi-trusted environment where only some clients are allowed
+         * to change the tracks data object, you should use "role based verification" to enforce those
+         * policies.
+         */
+        this.canSetPlaybackRate = true;
+        /**
+         * Controls whether or not the local client is allowed to send position updates to the group.
+         *
+         * @remarks
+         * This flag largely meant to limit the number of signals sent to the group for performance reasons.
+         * It does not provide any security in itself.
+         */
+        this.canSendPositionUpdates = true;
+        this._id = id;
+        this._runtime = runtime;
+        this._liveRuntime = liveRuntime;
+        this._logger = new LiveTelemetryLogger(runtime, liveRuntime);
+        this._getPlayerState = getPlayerState;
+    }
+    /**
+     * Returns true if the local client is in a suspended state.
+     */
+    get isSuspended() {
+        return this._groupState ? this._groupState.isSuspended : false;
+    }
+    /**
+     * Controls whether or not to scale {@link maxPlaybackDrift} by the number of users in the session.
+     *
+     * @remarks
+     * As more clients join a session, it is more likely that some users will fall behind the presenter.
+     * It is also less likely that users will notice drift as more clients are added.
+     * It is usually helpful to be more lenient as more clients are added so everyone can watch all the content.
+     * Default value is true.
+     */
+    get shouldScaleMaxPlaybackDrift() {
+        return this._maxPlaybackDrift.shouldPrioritize;
+    }
+    set shouldScaleMaxPlaybackDrift(value) {
+        this._maxPlaybackDrift.shouldPrioritize = value;
+    }
+    /**
+     * Max amount of playback drift allowed in seconds.
+     * This will scale automatically according to the number of participants in the session when {@link shouldScaleMaxPlaybackDrift} is true.
+     *
+     * @remarks
+     * Should the local clients playback position lag by more than the specified value, the coordinator will trigger a `catchup` action.
+     * Default value is `1.5` seconds.
+     */
+    get maxPlaybackDrift() {
+        return this._maxPlaybackDrift.seconds;
+    }
+    set maxPlaybackDrift(value) {
+        this._maxPlaybackDrift.seconds = value;
+    }
+    /**
+     * Controls whether or not to compute {@link positionUpdateInterval} based on whether user has initiated a playback command.
+     * Default value is true.
+     *
+     * @remarks
+     * When true, users that are simply watching but not controlling playback will report their positions less frequently.
+     * When a user has sent a transport command, they will begin sending position updates more frequently.
+     * Most Live Share apps have a concept of a primary presenter, and don't allow anyone to pause/play for the group.
+     * By ensuring only one/few users broadcast updates frequently, the server load is reduced considerably.
+     */
+    get shouldScalePositionUpdateInterval() {
+        return this._positionUpdateInterval.shouldPrioritize;
+    }
+    set shouldScalePositionUpdateInterval(value) {
+        this._positionUpdateInterval.shouldPrioritize = value;
+    }
+    /**
+     * Frequency with which position updates are broadcast to the rest of the group in seconds.
+     * When {@link shouldScalePositionUpdateInterval} is set to `true`, the value set is the minimum value.
+     * The value returned is the actual value used to send updates by the local user, which may be larger than the value set.
+     *
+     * @remarks
+     * Defaults to a minimum value of `2` seconds.
+     */
+    get positionUpdateInterval() {
+        return this._positionUpdateInterval.seconds;
+    }
+    set positionUpdateInterval(value) {
+        this._positionUpdateInterval.seconds = value;
+    }
+    /**
+     * Instructs the group to play the current track.
+     *
+     * @remarks
+     * Throws an exception if the session/coordinator hasn't been initialized, no track has been
+     * loaded, or `canPlayPause` is false.
+     *
+     * @returns a void promise that resolves once complete, throws if user does not have proper roles
+     */
+    play() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            LiveDataObjectNotInitializedError.assert("LiveMediaSessionCoordinator:play", "play", this.initializeState);
+            TrackMetadataNotSetError.assert(!!((_a = this._groupState) === null || _a === void 0 ? void 0 : _a.playbackTrack.current.metadata), "LiveMediaSessionCoordinator:play", "play");
+            ActionBlockedError.assert(this.canPlayPause, "LiveMediaSessionCoordinator:play", "play", "canPlayPause");
+            // Get projected position
+            const position = this.getPlayerPosition();
+            // Send transport command
+            this._logger.sendTelemetryEvent(TelemetryEvents.SessionCoordinator.PlayCalled, null, { position: position });
+            yield this._playEvent.sendEvent({
+                track: this._groupState.playbackTrack.current,
+                position: position,
+            });
+            if (this.canSendPositionUpdates) {
+                // User has taken initiative to send event, give priority for sending position updates
+                this._positionUpdateInterval.hasPriority = true;
+            }
+        });
+    }
+    /**
+     * Instructs the group to pause the current track.
+     *
+     * @remarks
+     * Throws an exception if the session/coordinator hasn't been initialized, no track has been
+     * loaded, or `canPlayPause` is false.
+     *
+     * @returns a void promise that resolves once complete, throws if user does not have proper roles
+     */
+    pause() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            LiveDataObjectNotInitializedError.assert("LiveMediaSessionCoordinator:pause", "pause", this.initializeState);
+            TrackMetadataNotSetError.assert(!!((_a = this._groupState) === null || _a === void 0 ? void 0 : _a.playbackTrack.current.metadata), "LiveMediaSessionCoordinator:pause", "pause");
+            ActionBlockedError.assert(this.canPlayPause, "LiveMediaSessionCoordinator:pause", "pause", "canPlayPause");
+            // Get projected position
+            const position = this.getPlayerPosition();
+            // Send transport command
+            this._logger.sendTelemetryEvent(TelemetryEvents.SessionCoordinator.PauseCalled, null, { position: position });
+            yield this._pauseEvent.sendEvent({
+                track: this._groupState.playbackTrack.current,
+                position: position,
+            });
+            if (this.canSendPositionUpdates) {
+                // User has taken initiative to send event, give priority for sending position updates
+                this._positionUpdateInterval.hasPriority = true;
+            }
+        });
+    }
+    /**
+     * Instructs the group to seek to a new position within the current track.
+     *
+     * @remarks
+     * Throws an exception if the session/coordinator hasn't been initialized, no track has been
+     * loaded, or `canSeek` is false.
+     * @param time Playback position in seconds to seek to.
+     * @returns a void promise that resolves once complete, throws if user does not have proper roles
+     */
+    seekTo(time) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            LiveDataObjectNotInitializedError.assert("LiveMediaSessionCoordinator:seekTo", "seekTo", this.initializeState);
+            TrackMetadataNotSetError.assert(!!((_a = this._groupState) === null || _a === void 0 ? void 0 : _a.playbackTrack.current.metadata), "LiveMediaSessionCoordinator:seekTo", "seekTo");
+            ActionBlockedError.assert(this.canSeek, "LiveMediaSessionCoordinator:seekTo", "seekTo", "canSeek");
+            // Send transport command
+            this._logger.sendTelemetryEvent(TelemetryEvents.SessionCoordinator.SeekToCalled, null, { position: time });
+            try {
+                yield this._seekToEvent.sendEvent({
+                    track: this._groupState.playbackTrack.current,
+                    position: time,
+                });
+                if (this.canSendPositionUpdates) {
+                    // User has taken initiative to send event, give priority for sending position updates
+                    this._positionUpdateInterval.hasPriority = true;
+                }
+            }
+            catch (err) {
+                yield this._groupState.syncLocalMediaSession();
+                throw err;
+            }
+        });
+    }
+    /**
+     * Sets the playback rate for everyone in the session.
+     *
+     * @param playbackRate the playback rate to set.
+     *
+     * @throws
+     * Throws an exception if the session/coordinator hasn't been initialized or {@link canSetPlaybackRate} is false.
+     */
+    setPlaybackRate(playbackRate) {
+        return __awaiter(this, void 0, void 0, function* () {
+            LiveDataObjectNotInitializedError.assert("LiveMediaSessionCoordinator:setPlaybackRate", "setPlaybackRate", this.initializeState);
+            ActionBlockedError.assert(this.canSetPlaybackRate, "LiveMediaSessionCoordinator:setPlaybackRate", "setPlaybackRate", "canSetPlaybackRate");
+            this._logger.sendTelemetryEvent(TelemetryEvents.SessionCoordinator.SetPlaybackRateCalled, null, { playbackRate });
+            yield this._rateChangeEvent.sendEvent({ playbackRate });
+            if (this.canSendPositionUpdates) {
+                // User has taken initiative to send event, give priority for sending position updates
+                this._positionUpdateInterval.hasPriority = true;
+            }
+        });
+    }
+    /**
+     * Instructs the group to load a new track.
+     *
+     * @remarks
+     * Throws an exception if the session/coordinator hasn't been initialized or `canSetTrack` is
+     * false.
+     * @param metadata The track to load or `null` to indicate that the end of the track is reached.
+     * @param waitPoints Optional. List of static wait points to configure for the track.  Dynamic wait points can be added via the `beginSuspension()` call.
+     * @returns a void promise that resolves once complete, throws if user does not have proper roles
+     */
+    setTrack(metadata, waitPoints) {
+        return __awaiter(this, void 0, void 0, function* () {
+            LiveDataObjectNotInitializedError.assert("LiveMediaSessionCoordinator:setTrack", "setTrack", this.initializeState);
+            ActionBlockedError.assert(this.canSetTrack, "LiveMediaSessionCoordinator:setTrack", "setTrack", "canSetTrack");
+            // Send transport command
+            this._logger.sendTelemetryEvent(TelemetryEvents.SessionCoordinator.SetTrackCalled);
+            yield this._setTrackEvent.sendEvent({
+                metadata: metadata,
+                waitPoints: waitPoints || [],
+            });
+            if (this.canSendPositionUpdates) {
+                // User has taken initiative to send event, give priority for sending position updates
+                this._positionUpdateInterval.hasPriority = true;
+            }
+        });
+    }
+    /**
+     * Updates the track data object for the current track.
+     *
+     * @remarks
+     * The track data object can be used by applications to synchronize things like pitch, roll,
+     * and yaw of a 360 video. This data object will be reset to null anytime the track changes.
+     *
+     * Throws an exception if the session/coordinator hasn't been initialized or `canSetTrackData` is
+     * false.
+     * @param data New data object to sync with the group. This value will be synchronized using a last writer wins strategy.
+     * @returns a void promise that resolves once complete, throws if user does not have proper roles
+     */
+    setTrackData(data) {
+        return __awaiter(this, void 0, void 0, function* () {
+            LiveDataObjectNotInitializedError.assert("LiveMediaSessionCoordinator:setTrackData", "setTrackData", this.initializeState);
+            ActionBlockedError.assert(this.canSetTrackData, "LiveMediaSessionCoordinator:setTrackData", "setTrackData", "canSetTrackData");
+            // Send transport command
+            this._logger.sendTelemetryEvent(TelemetryEvents.SessionCoordinator.SetTrackDataCalled);
+            yield this._setTrackDataEvent.sendEvent({
+                data: data,
+            });
+            if (this.canSendPositionUpdates) {
+                // User has taken initiative to send event, give priority for sending position updates
+                this._positionUpdateInterval.hasPriority = true;
+            }
+        });
+    }
+    /**
+     * Begins a new local suspension.
+     *
+     * @remarks
+     * Suspension temporarily suspend the clients local synchronization with the group. This can
+     * be useful for displaying ads to users or temporarily disconnecting from the session while
+     * the user seeks the video using a timeline scrubber.
+     *
+     * Multiple simultaneous suspensions are allowed and when the last suspension ends the local
+     * client will be immediately re-synchronized with the group.
+     *
+     * A "Dynamic Wait Point" can be specified when `beginSuspension()` is called and the wait
+     * point will be broadcast to all other clients in the group.  Those clients will then
+     * automatically enter a suspension state once they reach the positions specified by the
+     * wait point. Clients that are passed the wait point will immediately suspend.
+     *
+     * Any wait point based suspension (dynamic or static) will result in all clients remaining
+     * in a suspension state until the list client ends their suspension. This behavior can be
+     * conditionally bypassed by settings the wait points `maxClients` value.
+     *
+     * Throws an exception if the session/coordinator hasn't been initialized.
+     * @param waitPoint Optional. Dynamic wait point to broadcast to all of the clients.
+     * @returns The suspension object. Call `end()` on the returned suspension to end the suspension.
+     */
+    beginSuspension(waitPoint) {
+        var _a;
+        LiveDataObjectNotInitializedError.assert("LiveMediaSessionCoordinator:beginSuspension", "beginSuspension", this.initializeState);
+        TrackMetadataNotSetError.assert(!!((_a = this._groupState) === null || _a === void 0 ? void 0 : _a.playbackTrack.current.metadata), "LiveMediaSessionCoordinator:beginSuspension", "beginSuspension");
+        // Tell group state that suspension is started
+        if (waitPoint) {
+            this._logger.sendTelemetryEvent(TelemetryEvents.SessionCoordinator.BeginSuspensionAndWait, null, {
+                position: waitPoint.position,
+                maxClients: waitPoint.maxClients,
+            });
+            this._lastWaitPoint = waitPoint;
+            this._groupState.beginSuspension(waitPoint);
+        }
+        else {
+            this._logger.sendTelemetryEvent(TelemetryEvents.SessionCoordinator.BeginSuspension);
+            this._groupState.beginSuspension();
+        }
+        // Return new suspension object
+        return new LiveMediaSessionCoordinatorSuspension(waitPoint, (time) => {
+            var _a, _b;
+            if (waitPoint) {
+                this._logger.sendTelemetryEvent(TelemetryEvents.SessionCoordinator.EndSuspensionAndWait, null, {
+                    position: waitPoint.position,
+                    maxClients: waitPoint.maxClients,
+                });
+            }
+            else {
+                this._logger.sendTelemetryEvent(TelemetryEvents.SessionCoordinator.EndSuspension);
+            }
+            this._groupState.endSuspension(time == undefined);
+            if (time != undefined &&
+                !((_a = this._groupState) === null || _a === void 0 ? void 0 : _a.isSuspended) &&
+                !((_b = this._groupState) === null || _b === void 0 ? void 0 : _b.isWaiting)) {
+                // Seek to new position
+                this.seekTo(Math.max(time, 0.0));
+            }
+        });
+    }
+    /**
+     * @hidden
+     * Called by MediaSession to verify the coordinator has been initialized.
+     */
+    get isInitialized() {
+        return this.initializeState === LiveDataObjectInitializeState.succeeded;
+    }
+    /**
+     * @hidden
+     * Called by MediaSession to start coordinator.
+     */
+    initialize(acceptTransportChangesFrom) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            LiveDataObjectInitializeNotNeededError.assert("LiveMediaSessionCoordinator:initialize", this.initializeState);
+            this.initializeState = LiveDataObjectInitializeState.pending;
+            try {
+                // Create children
+                yield this.createChildren(acceptTransportChangesFrom);
+            }
+            catch (error) {
+                this.initializeState = LiveDataObjectInitializeState.needed;
+                throw error;
+            }
+            this.initializeState = LiveDataObjectInitializeState.succeeded;
+            try {
+                // start needs to happen after setting initializedState to "succeeded"
+                yield ((_a = this._synchronizer) === null || _a === void 0 ? void 0 : _a.start({
+                    initialState: undefined,
+                    updateState: (evt, sender, local) => __awaiter(this, void 0, void 0, function* () { return false; }),
+                    getLocalUserCanSend: (connecting) => __awaiter(this, void 0, void 0, function* () { return true; }),
+                    enableBackgroundUpdates: false,
+                }));
+            }
+            catch (error) {
+                // not a fatal error for LiveMediaSession, only used for "connect" event to send new clients position updates.
+                this._logger.sendErrorEvent(TelemetryEvents.SessionCoordinator
+                    .LiveObjectSynchronizerStartError, error);
+            }
+        });
+    }
+    /**
+     * @hidden
+     * Called by the MediaSession to detect if a wait point has been hit.
+     */
+    findNextWaitPoint() {
+        var _a;
+        return (((_a = this._groupState) === null || _a === void 0 ? void 0 : _a.playbackTrack.findNextWaitPoint(this._lastWaitPoint)) || null);
+    }
+    /**
+     * @hidden
+     * Called by MediaSession to trigger the sending of a position update.
+     */
+    sendPositionUpdate(state, targetClientId) {
+        var _a, _b;
+        LiveDataObjectNotInitializedError.assert("LiveMediaSessionCoordinator:sendPositionUpdate", "sendPositionUpdate", this.initializeState);
+        if (this.canSendPositionUpdates) {
+            // Send position update event
+            const evt = this._groupState.createPositionUpdateEvent(state);
+            (_a = this._positionUpdateEvent) === null || _a === void 0 ? void 0 : _a.sendEvent(evt, targetClientId).catch((err) => {
+                this._logger.sendErrorEvent(TelemetryEvents.SessionCoordinator
+                    .PositionUpdateEventError, err);
+            });
+        }
+        else if (this.isSuspended) {
+            // send a local only position update event that was not sent as a signal, and use to handle local
+            // position update for clients that have canSendPositionUpdates==false, but are suspending
+            const evt = this._groupState.createPositionUpdateEvent(state);
+            (_b = this._positionUpdateEvent) === null || _b === void 0 ? void 0 : _b.sendLocalEvent(evt).catch((err) => {
+                this._logger.sendErrorEvent(TelemetryEvents.SessionCoordinator.PositionUpdateEventError, err);
+            });
+        }
+        else {
+            // make sure position is synced to position of clients who can send position updates
+            this._groupState.syncLocalMediaSession();
+        }
+    }
+    createChildren(acceptTransportChangesFrom) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Create event scopes
+            const scope = new LiveEventScope(this._runtime, this._liveRuntime, acceptTransportChangesFrom);
+            const unrestrictedScope = new LiveEventScope(this._runtime, this._liveRuntime);
+            // Initialize internal coordinator state
+            this._groupState = new GroupCoordinatorState(this._runtime, this._liveRuntime, this._maxPlaybackDrift, this._positionUpdateInterval, this._getPlayerState);
+            this._groupState.on(GroupCoordinatorStateEvents.triggeraction, (evt) => this.emit(evt.name, evt));
+            this._groupState.on(GroupCoordinatorStateEvents.triggeractionignored, (evt) => this.emit(evt.name, evt));
+            // Listen for track changes
+            this._setTrackEvent = new LiveEventTarget(scope, "setTrack", (event, local) => this._groupState.handleSetTrack(event, local));
+            this._setTrackDataEvent = new LiveEventTarget(scope, "setTrackData", (event, local) => this._groupState.handleSetTrackData(event, local));
+            // Listen for transport commands
+            this._playEvent = new LiveEventTarget(scope, "play", (event, local) => this._groupState.handleTransportCommand(event, local));
+            this._pauseEvent = new LiveEventTarget(scope, "pause", (event, local) => this._groupState.handleTransportCommand(event, local));
+            this._seekToEvent = new LiveEventTarget(scope, "seekTo", (event, local) => this._groupState.handleTransportCommand(event, local));
+            this._rateChangeEvent = new LiveEventTarget(scope, "rateChange", (event, local) => {
+                this._groupState.handleRateChangeCommand(event, local);
+            });
+            // Listen for position updates
+            this._positionUpdateEvent = new LiveEventTarget(unrestrictedScope, "positionUpdate", (event, local) => this._groupState.handlePositionUpdate(event, local));
+            this._synchronizer = new LiveObjectSynchronizer(this._id, this._runtime, this._liveRuntime);
+            this._synchronizer.onJoinedListener = (clientId, timestamp) => {
+                this._logger.sendTelemetryEvent(TelemetryEvents.SessionCoordinator.RemoteConnectReceived, null, {
+                    correlationId: LiveTelemetryLogger.formatCorrelationId(clientId, timestamp),
+                });
+                // Immediately send a position update
+                try {
+                    const state = this._getPlayerState();
+                    // Send only to the user that joined the session using the targetClientId prop.
+                    // This ensures that only the user that connected receives this one-time position update, minimizing costs.
+                    this.sendPositionUpdate(state, clientId);
+                }
+                catch (err) {
+                    // if player is not setup yet, local client might have also just joined and can't send its position.
+                    const playerNotSetup = isErrorLike(err) &&
+                        err.message.includes("LiveMediaSession:getCurrentPlayerState");
+                    if (!playerNotSetup) {
+                        throw err;
+                    }
+                }
+            };
+        });
+    }
+    getPlayerPosition() {
+        const { positionState, playbackState } = this._getPlayerState();
+        switch (playbackState) {
+            case "none":
+            case "ended":
+                return 0.0;
+            default:
+                return positionState && positionState.position != undefined
+                    ? positionState.position
+                    : 0.0;
+        }
+    }
+}
+//# sourceMappingURL=LiveMediaSessionCoordinator.js.map

package/bin/esm/LiveMediaSessionCoordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveMediaSessionCoordinator.js","sourceRoot":"","sources":["../../src/LiveMediaSessionCoordinator.ts"],"names":[],"mappings":"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"}

package/bin/esm/LiveMediaSessionCoordinatorSuspension.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the Microsoft Live Share SDK License.
+ */
+import { MediaSessionCoordinatorSuspension, CoordinationWaitPoint } from "./MediaSessionExtensions.js";
+export declare class LiveMediaSessionCoordinatorSuspension implements MediaSessionCoordinatorSuspension {
+    private _waitPoint?;
+    private _onEnd;
+    constructor(waitPoint: CoordinationWaitPoint | undefined, onEnd: (seekTo?: number) => void);
+    /**
+     * Returns an optional wait point associated with the suspension.
+     */
+    get waitPoint(): CoordinationWaitPoint | undefined;
+    /**
+     * Ends the suspension and optionally proposes a time to seek to.
+     * @param seekTo Optional. Proposed time to seek to. Ignored for suspensions at wait points.
+     */
+    end(seekTo?: number): void;
+}
+//# sourceMappingURL=LiveMediaSessionCoordinatorSuspension.d.ts.map

package/bin/esm/LiveMediaSessionCoordinatorSuspension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveMediaSessionCoordinatorSuspension.d.ts","sourceRoot":"","sources":["../../src/LiveMediaSessionCoordinatorSuspension.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,iCAAiC,EACjC,qBAAqB,EACxB,MAAM,6BAA6B,CAAC;AAErC,qBAAa,qCAAsC,YAAW,iCAAiC;IAC3F,OAAO,CAAC,UAAU,CAAC,CAAwB;IAC3C,OAAO,CAAC,MAAM,CAA4B;gBAGtC,SAAS,EAAE,qBAAqB,GAAG,SAAS,EAC5C,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI;IAMpC;;OAEG;IACH,IAAW,SAAS,IAAI,qBAAqB,GAAG,SAAS,CAExD;IAED;;;OAGG;IACI,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;CAGpC"}

package/bin/esm/LiveMediaSessionCoordinatorSuspension.js

@@ -0,0 +1,24 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the Microsoft Live Share SDK License.
+ */
+export class LiveMediaSessionCoordinatorSuspension {
+    constructor(waitPoint, onEnd) {
+        this._waitPoint = waitPoint;
+        this._onEnd = onEnd;
+    }
+    /**
+     * Returns an optional wait point associated with the suspension.
+     */
+    get waitPoint() {
+        return this._waitPoint;
+    }
+    /**
+     * Ends the suspension and optionally proposes a time to seek to.
+     * @param seekTo Optional. Proposed time to seek to. Ignored for suspensions at wait points.
+     */
+    end(seekTo) {
+        this._onEnd(seekTo);
+    }
+}
+//# sourceMappingURL=LiveMediaSessionCoordinatorSuspension.js.map

package/bin/esm/LiveMediaSessionCoordinatorSuspension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveMediaSessionCoordinatorSuspension.js","sourceRoot":"","sources":["../../src/LiveMediaSessionCoordinatorSuspension.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,OAAO,qCAAqC;IAI9C,YACI,SAA4C,EAC5C,KAAgC;QAEhC,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,IAAW,SAAS;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACI,GAAG,CAAC,MAAe;QACtB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;CACJ"}