@microsoft/live-share-media 0.5.1 → 1.0.0-preview.3

package/bin/internals/consts.js

@@ -12,66 +12,66 @@ exports.TelemetryEvents = void 0;
  */
 exports.TelemetryEvents = {
     MediaPlayerSynchronizer: {
-        SynchronizationStarted: 'MediaPlayerSynchronizer:SynchronizationStarted',
-        PlayerEvent: 'MediaPlayerSynchronizer:PlayerEvent',
-        PlayAction: 'MediaPlayerSynchronizer:PlayAction',
-        PauseAction: 'MediaPlayerSynchronizer:PauseAction',
-        SeekToAction: 'MediaPlayerSynchronizer:SeekToAction',
-        CatchupAction: 'MediaPlayerSynchronizer:CatchupAction',
-        SetTrackAction: 'MediaPlayerSynchronizer:SetTrackAction',
-        DataChangeAction: 'MediaPlayerSynchronizer:DataChangeAction',
-        UserTappedVideoToPlay: transmit('MediaPlayerSynchronizer:UserTappedVideoToPlay'),
-        PlaybackRateChangeBlocked: 'MediaPlayerSynchronizer:PlaybackRateChangeBlocked',
-        PlayerBlockedOperation: transmit('MediaPlayerSynchronizer:PlayerBlockedOperation'),
-        SeekingPlayerToStartPosition: 'MediaPlayerSynchronizer:SeekingPlayerToStartPosition',
-        BeginSeekCalled: 'MediaPlayerSynchronizer:BeginSeekCalled',
-        EndSeekCalled: 'MediaPlayerSynchronizer:EndSeekCalled',
-        PlayCalled: 'MediaPlayerSynchronizer:PlayCalled',
-        PauseCalled: 'MediaPlayerSynchronizer:PauseCalled',
-        SeekToCalled: 'MediaPlayerSynchronizer:SeekToCalled',
-        SetTrackCalled: 'MediaPlayerSynchronizer:SetTrackCalled',
-        SetTrackDataCalled: 'MediaPlayerSynchronizer:SetTrackDataCalled',
+        SynchronizationStarted: "MediaPlayerSynchronizer:SynchronizationStarted",
+        PlayerEvent: "MediaPlayerSynchronizer:PlayerEvent",
+        PlayAction: "MediaPlayerSynchronizer:PlayAction",
+        PauseAction: "MediaPlayerSynchronizer:PauseAction",
+        SeekToAction: "MediaPlayerSynchronizer:SeekToAction",
+        CatchupAction: "MediaPlayerSynchronizer:CatchupAction",
+        SetTrackAction: "MediaPlayerSynchronizer:SetTrackAction",
+        DataChangeAction: "MediaPlayerSynchronizer:DataChangeAction",
+        UserTappedVideoToPlay: transmit("MediaPlayerSynchronizer:UserTappedVideoToPlay"),
+        PlaybackRateChangeBlocked: "MediaPlayerSynchronizer:PlaybackRateChangeBlocked",
+        PlayerBlockedOperation: transmit("MediaPlayerSynchronizer:PlayerBlockedOperation"),
+        SeekingPlayerToStartPosition: "MediaPlayerSynchronizer:SeekingPlayerToStartPosition",
+        BeginSeekCalled: "MediaPlayerSynchronizer:BeginSeekCalled",
+        EndSeekCalled: "MediaPlayerSynchronizer:EndSeekCalled",
+        PlayCalled: "MediaPlayerSynchronizer:PlayCalled",
+        PauseCalled: "MediaPlayerSynchronizer:PauseCalled",
+        SeekToCalled: "MediaPlayerSynchronizer:SeekToCalled",
+        SetTrackCalled: "MediaPlayerSynchronizer:SetTrackCalled",
+        SetTrackDataCalled: "MediaPlayerSynchronizer:SetTrackDataCalled",
     },
     MediaSession: {
-        PlayAction: transmit('MediaSession:PlayAction'),
-        PauseAction: transmit('MediaSession:PauseAction'),
-        SeekToAction: transmit('MediaSession:SeekToAction'),
-        CatchUpAction: transmit('MediaSession:CatchUpAction'),
-        SetTrackAction: transmit('MediaSession:SetTrackAction'),
-        DataChangeAction: 'MediaSession:DataChangeAction',
-        BeginPositionUpdateTimer: 'MediaSession:BeginPositionUpdateTimer',
+        PlayAction: transmit("MediaSession:PlayAction"),
+        PauseAction: transmit("MediaSession:PauseAction"),
+        SeekToAction: transmit("MediaSession:SeekToAction"),
+        CatchUpAction: transmit("MediaSession:CatchUpAction"),
+        SetTrackAction: transmit("MediaSession:SetTrackAction"),
+        DataChangeAction: "MediaSession:DataChangeAction",
+        BeginPositionUpdateTimer: "MediaSession:BeginPositionUpdateTimer",
     },
     SessionCoordinator: {
-        PlayCalled: transmit('SessionCoordinator:PlayCalled'),
-        PauseCalled: transmit('SessionCoordinator:PauseCalled'),
-        SeekToCalled: transmit('SessionCoordinator:SeekToCalled'),
-        SetTrackCalled: transmit('SessionCoordinator:SetTrackCalled'),
-        SetTrackDataCalled: 'SessionCoordinator:SetTrackDataCalled',
-        BeginSuspension: 'SessionCoordinator:BeginSuspension',
-        BeginSuspensionAndWait: transmit('SessionCoordinator:BeginSuspensionAndWait'),
-        EndSuspension: 'SessionCoordinator:EndSuspension',
-        EndSuspensionAndWait: transmit('SessionCoordinator:EndSuspensionAndWait'),
-        RemoteJoinReceived: 'SessionCoordinator:RemoteJoinReceived',
-        RemoteSetTrackReceived: transmit('SessionCoordinator:RemoteSetTrackReceived'),
-        RemoteSetTrackDataReceived: transmit('SessionCoordinator:RemoteSetTrackDataReceived'),
-        RemotePlayReceived: transmit('SessionCoordinator:RemotePlayReceived'),
-        RemotePauseReceived: transmit('SessionCoordinator:RemotePauseReceived'),
-        RemoteSeekToReceived: transmit('SessionCoordinator:RemoteSeekToReceived'),
+        PlayCalled: transmit("SessionCoordinator:PlayCalled"),
+        PauseCalled: transmit("SessionCoordinator:PauseCalled"),
+        SeekToCalled: transmit("SessionCoordinator:SeekToCalled"),
+        SetTrackCalled: transmit("SessionCoordinator:SetTrackCalled"),
+        SetTrackDataCalled: "SessionCoordinator:SetTrackDataCalled",
+        BeginSuspension: "SessionCoordinator:BeginSuspension",
+        BeginSuspensionAndWait: transmit("SessionCoordinator:BeginSuspensionAndWait"),
+        EndSuspension: "SessionCoordinator:EndSuspension",
+        EndSuspensionAndWait: transmit("SessionCoordinator:EndSuspensionAndWait"),
+        RemoteJoinReceived: "SessionCoordinator:RemoteJoinReceived",
+        RemoteSetTrackReceived: transmit("SessionCoordinator:RemoteSetTrackReceived"),
+        RemoteSetTrackDataReceived: transmit("SessionCoordinator:RemoteSetTrackDataReceived"),
+        RemotePlayReceived: transmit("SessionCoordinator:RemotePlayReceived"),
+        RemotePauseReceived: transmit("SessionCoordinator:RemotePauseReceived"),
+        RemoteSeekToReceived: transmit("SessionCoordinator:RemoteSeekToReceived"),
     },
     GroupCoordinator: {
-        TrackChanged: 'GroupCoordinator:TrackChanged',
-        TrackChangeDelayed: 'GroupCoordinator:TrackChangeDelayed',
-        TrackDataChanged: 'GroupCoordinator:TrackDataChanged',
-        TrackDataChangeDelayed: 'GroupCoordinator:TrackDataChangeDelayed',
-        TransportStateChanged: 'GroupCoordinator:TransportStateChanged',
-        TransportStateChangeDelayed: 'GroupCoordinator:TransportStateChangeDelayed',
-        BeginSoftSuspension: 'GroupCoordinator:BeginSoftSuspension',
-        CheckingForSyncIssues: 'GroupCoordinator:CheckingForSyncIssues',
-        TrackOutOfSync: transmit('GroupCoordinator:TrackOutOfSync'),
-        TrackDataOutOfSync: transmit('GroupCoordinator:TrackDataOutOfSync'),
-        TransportOutOfSync: transmit('GroupCoordinator:TransportOutOfSync'),
-        PositionOutOfSync: transmit('GroupCoordinator:PositionOutOfSync'),
-    }
+        TrackChanged: "GroupCoordinator:TrackChanged",
+        TrackChangeDelayed: "GroupCoordinator:TrackChangeDelayed",
+        TrackDataChanged: "GroupCoordinator:TrackDataChanged",
+        TrackDataChangeDelayed: "GroupCoordinator:TrackDataChangeDelayed",
+        TransportStateChanged: "GroupCoordinator:TransportStateChanged",
+        TransportStateChangeDelayed: "GroupCoordinator:TransportStateChangeDelayed",
+        BeginSoftSuspension: "GroupCoordinator:BeginSoftSuspension",
+        CheckingForSyncIssues: "GroupCoordinator:CheckingForSyncIssues",
+        TrackOutOfSync: transmit("GroupCoordinator:TrackOutOfSync"),
+        TrackDataOutOfSync: transmit("GroupCoordinator:TrackDataOutOfSync"),
+        TransportOutOfSync: transmit("GroupCoordinator:TransportOutOfSync"),
+        PositionOutOfSync: transmit("GroupCoordinator:PositionOutOfSync"),
+    },
 };
 /**
  * @hidden

package/bin/internals/consts.js.map

@@ -1 +1 @@
-{"version":3,"file":"consts.js","sourceRoot":"","sources":["../../src/internals/consts.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH;;;;GAIG;AACU,QAAA,eAAe,GAAG;IAC3B,uBAAuB,EAAE;QACrB,sBAAsB,EAAE,gDAAgD;QACxE,WAAW,EAAE,qCAAqC;QAClD,UAAU,EAAE,oCAAoC;QAChD,WAAW,EAAE,qCAAqC;QAClD,YAAY,EAAE,sCAAsC;QACpD,aAAa,EAAE,uCAAuC;QACtD,cAAc,EAAE,wCAAwC;QACxD,gBAAgB,EAAE,0CAA0C;QAC5D,qBAAqB,EAAE,QAAQ,CAAC,+CAA+C,CAAC;QAChF,yBAAyB,EAAE,mDAAmD;QAC9E,sBAAsB,EAAE,QAAQ,CAAC,gDAAgD,CAAC;QAClF,4BAA4B,EAAE,sDAAsD;QACpF,eAAe,EAAE,yCAAyC;QAC1D,aAAa,EAAE,uCAAuC;QACtD,UAAU,EAAE,oCAAoC;QAChD,WAAW,EAAE,qCAAqC;QAClD,YAAY,EAAE,sCAAsC;QACpD,cAAc,EAAE,wCAAwC;QACxD,kBAAkB,EAAE,4CAA4C;KACnE;IACD,YAAY,EAAE;QACV,UAAU,EAAE,QAAQ,CAAC,yBAAyB,CAAC;QAC/C,WAAW,EAAE,QAAQ,CAAC,0BAA0B,CAAC;QACjD,YAAY,EAAE,QAAQ,CAAC,2BAA2B,CAAC;QACnD,aAAa,EAAE,QAAQ,CAAC,4BAA4B,CAAC;QACrD,cAAc,EAAE,QAAQ,CAAC,6BAA6B,CAAC;QACvD,gBAAgB,EAAE,+BAA+B;QACjD,wBAAwB,EAAE,uCAAuC;KACpE;IACD,kBAAkB,EAAE;QAChB,UAAU,EAAE,QAAQ,CAAC,+BAA+B,CAAC;QACrD,WAAW,EAAE,QAAQ,CAAC,gCAAgC,CAAC;QACvD,YAAY,EAAE,QAAQ,CAAC,iCAAiC,CAAC;QACzD,cAAc,EAAE,QAAQ,CAAC,mCAAmC,CAAC;QAC7D,kBAAkB,EAAE,uCAAuC;QAC3D,eAAe,EAAE,oCAAoC;QACrD,sBAAsB,EAAE,QAAQ,CAAC,2CAA2C,CAAC;QAC7E,aAAa,EAAE,kCAAkC;QACjD,oBAAoB,EAAE,QAAQ,CAAC,yCAAyC,CAAC;QACzE,kBAAkB,EAAE,uCAAuC;QAC3D,sBAAsB,EAAE,QAAQ,CAAC,2CAA2C,CAAC;QAC7E,0BAA0B,EAAE,QAAQ,CAAC,+CAA+C,CAAC;QACrF,kBAAkB,EAAE,QAAQ,CAAC,uCAAuC,CAAC;QACrE,mBAAmB,EAAE,QAAQ,CAAC,wCAAwC,CAAC;QACvE,oBAAoB,EAAE,QAAQ,CAAC,yCAAyC,CAAC;KAC5E;IACD,gBAAgB,EAAE;QACd,YAAY,EAAE,+BAA+B;QAC7C,kBAAkB,EAAE,qCAAqC;QACzD,gBAAgB,EAAE,mCAAmC;QACrD,sBAAsB,EAAE,yCAAyC;QACjE,qBAAqB,EAAE,wCAAwC;QAC/D,2BAA2B,EAAE,8CAA8C;QAC3E,mBAAmB,EAAE,sCAAsC;QAC3D,qBAAqB,EAAE,wCAAwC;QAC/D,cAAc,EAAE,QAAQ,CAAC,iCAAiC,CAAC;QAC3D,kBAAkB,EAAE,QAAQ,CAAC,qCAAqC,CAAC;QACnE,kBAAkB,EAAE,QAAQ,CAAC,qCAAqC,CAAC;QACnE,iBAAiB,EAAE,QAAQ,CAAC,oCAAoC,CAAC;KACpE;CACJ,CAAA;AAED;;GAEG;AACH,SAAS,QAAQ,CAAC,SAAiB;IAC/B,OAAO,GAAG,SAAS,WAAW,CAAC;AACnC,CAAC"}
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../../src/internals/consts.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH;;;;GAIG;AACU,QAAA,eAAe,GAAG;IAC3B,uBAAuB,EAAE;QACrB,sBAAsB,EAClB,gDAAgD;QACpD,WAAW,EAAE,qCAAqC;QAClD,UAAU,EAAE,oCAAoC;QAChD,WAAW,EAAE,qCAAqC;QAClD,YAAY,EAAE,sCAAsC;QACpD,aAAa,EAAE,uCAAuC;QACtD,cAAc,EAAE,wCAAwC;QACxD,gBAAgB,EAAE,0CAA0C;QAC5D,qBAAqB,EAAE,QAAQ,CAC3B,+CAA+C,CAClD;QACD,yBAAyB,EACrB,mDAAmD;QACvD,sBAAsB,EAAE,QAAQ,CAC5B,gDAAgD,CACnD;QACD,4BAA4B,EACxB,sDAAsD;QAC1D,eAAe,EAAE,yCAAyC;QAC1D,aAAa,EAAE,uCAAuC;QACtD,UAAU,EAAE,oCAAoC;QAChD,WAAW,EAAE,qCAAqC;QAClD,YAAY,EAAE,sCAAsC;QACpD,cAAc,EAAE,wCAAwC;QACxD,kBAAkB,EAAE,4CAA4C;KACnE;IACD,YAAY,EAAE;QACV,UAAU,EAAE,QAAQ,CAAC,yBAAyB,CAAC;QAC/C,WAAW,EAAE,QAAQ,CAAC,0BAA0B,CAAC;QACjD,YAAY,EAAE,QAAQ,CAAC,2BAA2B,CAAC;QACnD,aAAa,EAAE,QAAQ,CAAC,4BAA4B,CAAC;QACrD,cAAc,EAAE,QAAQ,CAAC,6BAA6B,CAAC;QACvD,gBAAgB,EAAE,+BAA+B;QACjD,wBAAwB,EAAE,uCAAuC;KACpE;IACD,kBAAkB,EAAE;QAChB,UAAU,EAAE,QAAQ,CAAC,+BAA+B,CAAC;QACrD,WAAW,EAAE,QAAQ,CAAC,gCAAgC,CAAC;QACvD,YAAY,EAAE,QAAQ,CAAC,iCAAiC,CAAC;QACzD,cAAc,EAAE,QAAQ,CAAC,mCAAmC,CAAC;QAC7D,kBAAkB,EAAE,uCAAuC;QAC3D,eAAe,EAAE,oCAAoC;QACrD,sBAAsB,EAAE,QAAQ,CAC5B,2CAA2C,CAC9C;QACD,aAAa,EAAE,kCAAkC;QACjD,oBAAoB,EAAE,QAAQ,CAC1B,yCAAyC,CAC5C;QACD,kBAAkB,EAAE,uCAAuC;QAC3D,sBAAsB,EAAE,QAAQ,CAC5B,2CAA2C,CAC9C;QACD,0BAA0B,EAAE,QAAQ,CAChC,+CAA+C,CAClD;QACD,kBAAkB,EAAE,QAAQ,CAAC,uCAAuC,CAAC;QACrE,mBAAmB,EAAE,QAAQ,CAAC,wCAAwC,CAAC;QACvE,oBAAoB,EAAE,QAAQ,CAC1B,yCAAyC,CAC5C;KACJ;IACD,gBAAgB,EAAE;QACd,YAAY,EAAE,+BAA+B;QAC7C,kBAAkB,EAAE,qCAAqC;QACzD,gBAAgB,EAAE,mCAAmC;QACrD,sBAAsB,EAAE,yCAAyC;QACjE,qBAAqB,EAAE,wCAAwC;QAC/D,2BAA2B,EACvB,8CAA8C;QAClD,mBAAmB,EAAE,sCAAsC;QAC3D,qBAAqB,EAAE,wCAAwC;QAC/D,cAAc,EAAE,QAAQ,CAAC,iCAAiC,CAAC;QAC3D,kBAAkB,EAAE,QAAQ,CAAC,qCAAqC,CAAC;QACnE,kBAAkB,EAAE,QAAQ,CAAC,qCAAqC,CAAC;QACnE,iBAAiB,EAAE,QAAQ,CAAC,oCAAoC,CAAC;KACpE;CACJ,CAAC;AAEF;;GAEG;AACH,SAAS,QAAQ,CAAC,SAAiB;IAC/B,OAAO,GAAG,SAAS,WAAW,CAAC;AACnC,CAAC"}

package/bin/internals/index.d.ts

@@ -2,10 +2,10 @@
  * Copyright (c) Microsoft Corporation. All rights reserved.
  * Licensed under the Microsoft Live Share SDK License.
  */
-export * from './consts';
-export * from './GroupCoordinatorState';
-export * from './GroupPlaybackPosition';
-export * from './GroupPlaybackTrack';
-export * from './GroupPlaybackTrackData';
-export * from './GroupTransportState';
+export * from "./consts";
+export * from "./GroupCoordinatorState";
+export * from "./GroupPlaybackPosition";
+export * from "./GroupPlaybackTrack";
+export * from "./GroupPlaybackTrackData";
+export * from "./GroupTransportState";
 //# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,38 +1,38 @@
-{
-    "name": "@microsoft/live-share-media",
-    "version": "0.5.1",
-    "description": "Live Share classes that synchronize media playback across clients.",
-    "author": "Microsoft",
-    "license": "SEE LICENSE IN LICENSE",
-    "main": "./bin/index.js",
-    "types": "./bin/index.d.ts",
-    "scripts": {
-        "clean": "npx shx rm -rf bin",
-        "build": "tsc -p tsconfig.build.json",
-        "test": "ts-mocha src/**/*.spec.ts --timeout 10000",
-        "test:debug": "ts-mocha src/**/*.spec.ts --inspect-brk",
-        "test:coverage": "nyc --reporter=html --reporter=text --reporter=text-summary npm test"
-    },
-    "dependencies": {
-        "fluid-framework": "~1.2.3",
-        "@microsoft/live-share": "0.5.1"
-    },
-    "devDependencies": {
-        "@types/assert": "^1.5.6",
-        "@types/mocha": "^9.0.0",
-        "@types/node": "^10.12.24",
-        "mocha": "^9.1.1",
-        "nyc": "^15.1.0",
-        "ts-mocha": "^9.0.2",
-        "typescript": "^4.6.4"
-    },
-    "repository": {
-        "directory": "packages/live-share-media",
-        "type": "git",
-        "url": "https://github.com/microsoft/live-share-sdk"
-    },
-    "homepage": "https://aka.ms/teamsliveshare",
-    "bugs": {
-        "url": "https://github.com/microsoft/live-share-sdk/issues"
-    }
-}
+{
+    "name": "@microsoft/live-share-media",
+    "version": "1.0.0-preview.3",
+    "description": "Live Share classes that synchronize media playback across clients.",
+    "author": "Microsoft",
+    "license": "SEE LICENSE IN LICENSE",
+    "main": "./bin/index.js",
+    "types": "./bin/index.d.ts",
+    "scripts": {
+        "clean": "npx shx rm -rf bin",
+        "build": "tsc -p tsconfig.build.json",
+        "test": "ts-mocha src/**/*.spec.ts --timeout 10000",
+        "test:debug": "ts-mocha src/**/*.spec.ts --inspect-brk",
+        "test:coverage": "nyc --reporter=html --reporter=text --reporter=text-summary npm test"
+    },
+    "dependencies": {
+        "fluid-framework": "~1.2.3",
+        "@microsoft/live-share": "1.0.0-preview.3"
+    },
+    "devDependencies": {
+        "@types/assert": "^1.5.6",
+        "@types/mocha": "^9.0.0",
+        "@types/node": "^18.11.0",
+        "mocha": "^9.1.1",
+        "nyc": "^15.1.0",
+        "ts-mocha": "^9.0.2",
+        "typescript": "^4.6.4"
+    },
+    "repository": {
+        "directory": "packages/live-share-media",
+        "type": "git",
+        "url": "https://github.com/microsoft/live-share-sdk"
+    },
+    "homepage": "https://aka.ms/teamsliveshare",
+    "bugs": {
+        "url": "https://github.com/microsoft/live-share-sdk/issues"
+    }
+}

package/src/IMediaPlayer.ts

@@ -1,21 +1,29 @@
-/**
- * Copyright (c) Microsoft Corporation. All rights reserved.
- * Licensed under the Microsoft Live Share SDK License.
- */
-
-export interface IMediaPlayer {
-    readonly currentSrc: string;
-    currentTime: number;
-    readonly duration: number;
-    readonly ended: boolean;
-    muted: boolean;
-    readonly paused: boolean;
-    playbackRate: number;
-    src: string;
-    volume: number;
-    load(): void;
-    pause(): void;
-    play(): Promise<void>;
-    addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
-    removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
-}
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the Microsoft Live Share SDK License.
+ */
+
+export interface IMediaPlayer {
+    readonly currentSrc: string;
+    currentTime: number;
+    readonly duration: number;
+    readonly ended: boolean;
+    muted: boolean;
+    readonly paused: boolean;
+    playbackRate: number;
+    src: string;
+    volume: number;
+    load(): void;
+    pause(): void;
+    play(): Promise<void>;
+    addEventListener(
+        type: string,
+        listener: EventListenerOrEventListenerObject,
+        options?: boolean | AddEventListenerOptions
+    ): void;
+    removeEventListener(
+        type: string,
+        listener: EventListenerOrEventListenerObject,
+        options?: boolean | EventListenerOptions
+    ): void;
+}

package/src/LiveMediaSession.ts

@@ -0,0 +1,300 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the Microsoft Live Share SDK License.
+ */
+
+import { DataObject, DataObjectFactory } from "@fluidframework/aqueduct";
+import { LiveTelemetryLogger, UserMeetingRole } from "@microsoft/live-share";
+import { MediaPlayerSynchronizer } from "./MediaPlayerSynchronizer";
+import { ITriggerActionEvent, TelemetryEvents } from "./internals";
+import {
+    MediaSessionCoordinatorEvents,
+    ExtendedMediaSessionAction,
+    ExtendedMediaSessionActionDetails,
+} from "./MediaSessionExtensions";
+import {
+    LiveMediaSessionCoordinator,
+    IMediaPlayerState,
+} from "./LiveMediaSessionCoordinator";
+import { MediaSessionActionThrottler } from "./MediaSessionActionThrottler";
+import { RepeatedActionThrottler } from "./RepeatedActionThrottler";
+import { IMediaPlayer } from "./IMediaPlayer";
+
+/**
+ * Live fluid object that synchronizes media playback across multiple clients.
+ */
+export class LiveMediaSession extends DataObject {
+    private _actionThrottler: MediaSessionActionThrottler =
+        new RepeatedActionThrottler();
+    private _logger?: LiveTelemetryLogger;
+    private _requestPlayerStateHandler?: () => IMediaPlayerState;
+    private _coordinator?: LiveMediaSessionCoordinator;
+    private readonly _actionHandlers: Map<string, MediaSessionActionHandler> =
+        new Map();
+    private _synchronizing?: MediaPlayerSynchronizer;
+
+    // Position update timer
+    private _updateTimer: any;
+    private _lastUpdateTime: number = 0;
+
+    /**
+     * The objects fluid type name.
+     */
+    public static readonly TypeName = `@microsoft/fluid-media:SharedMediaSession`;
+
+    /**
+     * The objects fluid type factory.
+     */
+    public static readonly factory = new DataObjectFactory(
+        LiveMediaSession.TypeName,
+        LiveMediaSession,
+        [],
+        {}
+    );
+
+    /**
+     * Extension point that lets applications replace the default logic for throttling the sessions
+     * local sync behavior.
+     *
+     * @remarks
+     * The `LiveMediaCoordinator` is fairly aggressive at wanting to keep the local media player
+     * in sync with the rest of the group. This aggressiveness can result in the coordinator sending
+     * new sync actions before the local player has finished responding to the previous sync action.
+     * The `ActionThrottler` gives apps fine grain control over how aggressive they want sync to be.
+     *
+     * By default, a `RepeatedAction` throttler is used which prevents the same sync action from
+     * being sent within an adjustable time period.
+     */
+    public get actionThrottler(): MediaSessionActionThrottler {
+        return this._actionThrottler;
+    }
+
+    public set actionThrottler(value: MediaSessionActionThrottler) {
+        this._actionThrottler = value;
+    }
+
+    /**
+     * Returns true if the object has been initialized.
+     */
+    public get isInitialized(): boolean {
+        return this.coordinator.isInitialized;
+    }
+
+    /**
+     * @deprecated isInitialized should be used instead
+     * Returns true if the object has been initialized.
+     */
+    public get isStarted(): boolean {
+        return this.isInitialized;
+    }
+
+    /**
+     * The group coordinator for the session.
+     */
+    public get coordinator(): LiveMediaSessionCoordinator {
+        return this._coordinator!;
+    }
+
+    /**
+     * Returns the logger used by the session and coordinator.
+     *
+     * @remarks
+     * This is used by the `MediaPlayerSynchronizer` to log events.
+     */
+    public get logger(): LiveTelemetryLogger {
+        return this._logger!;
+    }
+
+    /**
+     * initialize the object.
+     * @param acceptTransportChangesFrom Optional. List of roles allowed to group transport
+     * operations like play/pause/seek/setTrack.
+     */
+    public initialize(
+        acceptTransportChangesFrom?: UserMeetingRole[]
+    ): Promise<void> {
+        return this.coordinator.initialize(acceptTransportChangesFrom);
+    }
+
+    /**
+     * Registers an action handler with the session.
+     * @param action Name of the action to register a handler for.
+     * @param handler Function called when the action is triggered.
+     */
+    public setActionHandler(
+        action: ExtendedMediaSessionAction,
+        handler: MediaSessionActionHandler | null
+    ): void {
+        if (handler) {
+            // add handler
+            this._actionHandlers.set(action, handler);
+        } else if (this._actionHandlers.has(action)) {
+            // remove handler
+            this._actionHandlers.delete(action);
+        }
+    }
+
+    /**
+     * Registers a handler that will be queried anytime the group coordinate needs to know the
+     * local players transport state and position.
+     */
+    public setRequestPlayerStateHandler(handler: () => IMediaPlayerState) {
+        this._requestPlayerStateHandler = handler;
+    }
+
+    /**
+     * Begins synchronizing the playback of a media element.
+     * @param player Something that "looks like" and HTML Media Element.
+     * @returns A new synchronizer instance. Call `synchronizer.end()` to stop synchronizing the elements playback.
+     */
+    public synchronize(player: IMediaPlayer): MediaPlayerSynchronizer {
+        // A session can only synchronize one player at a time
+        if (this._synchronizing) {
+            this._synchronizing.end();
+        }
+
+        // Start position update timer
+        if (!this._updateTimer) {
+            this.logger.sendTelemetryEvent(
+                TelemetryEvents.MediaSession.BeginPositionUpdateTimer
+            );
+            this._updateTimer = setInterval(() => {
+                // Get current state
+                const state = this.getCurrentPlayerState();
+
+                // Check for hit wait point
+                this.checkWaitPointHit(state);
+
+                // Send position update if interval hit
+                const now = new Date().getTime();
+                const delta = (now - this._lastUpdateTime) / 1000;
+                if (
+                    this.coordinator.isInitialized &&
+                    delta >= this.coordinator.positionUpdateInterval
+                ) {
+                    this._lastUpdateTime = now;
+                    this.coordinator.sendPositionUpdate(state);
+                }
+            }, 500);
+        }
+
+        return new MediaPlayerSynchronizer(player, this, () => {
+            this._synchronizing = undefined;
+        });
+    }
+
+    protected async hasInitialized(): Promise<void> {
+        this._logger = new LiveTelemetryLogger(this.runtime);
+
+        // Create coordinator and listen for triggered actions
+        this._coordinator = new LiveMediaSessionCoordinator(this.runtime, () =>
+            this.getCurrentPlayerState()
+        );
+        this._coordinator.on(
+            MediaSessionCoordinatorEvents.triggeraction,
+            (event: ITriggerActionEvent) => {
+                // Pre-process actions
+                const details = event.details;
+                const seekTime =
+                    typeof details.seekTime == "number" ? details.seekTime : -1;
+                switch (details.action) {
+                    case "play":
+                        this.logger.sendTelemetryEvent(
+                            TelemetryEvents.MediaSession.PlayAction,
+                            null,
+                            {
+                                position: seekTime,
+                            }
+                        );
+                        break;
+                    case "pause":
+                        this.logger.sendTelemetryEvent(
+                            TelemetryEvents.MediaSession.PauseAction,
+                            null,
+                            {
+                                position: seekTime,
+                            }
+                        );
+                        break;
+                    case "seekto":
+                        this.logger.sendTelemetryEvent(
+                            TelemetryEvents.MediaSession.SeekToAction,
+                            null,
+                            {
+                                position: seekTime,
+                            }
+                        );
+                        break;
+                    case "settrack":
+                        this.logger.sendTelemetryEvent(
+                            TelemetryEvents.MediaSession.SetTrackAction
+                        );
+                        break;
+                    case "datachange":
+                        this.logger.sendTelemetryEvent(
+                            TelemetryEvents.MediaSession.DataChangeAction
+                        );
+                        break;
+                    case "catchup":
+                        // Default to seekto if catchup not implemented
+                        this.logger.sendTelemetryEvent(
+                            TelemetryEvents.MediaSession.CatchUpAction,
+                            null,
+                            {
+                                position: seekTime,
+                            }
+                        );
+                        if (!this._actionHandlers.has("catchup")) {
+                            details.action = "seekto";
+                        }
+                        break;
+                }
+
+                // Dispatch action
+                this.dispatchAction(details);
+            }
+        );
+    }
+
+    private checkWaitPointHit(state: IMediaPlayerState): void {
+        // Was a wait point hit?
+        if (state.positionState && this.coordinator.isInitialized) {
+            const waitPoint = this.coordinator.findNextWaitPoint();
+            if (
+                waitPoint &&
+                state.positionState.position != undefined &&
+                state.positionState.position >= waitPoint.position
+            ) {
+                // Ensure handler registered
+                if (!this._actionHandlers.has("wait")) {
+                    throw new Error(
+                        `SharedMediaSession: wait point hit but no 'wait' action registered.`
+                    );
+                }
+
+                // Begin suspension for wait point
+                const suspension = this.coordinator.beginSuspension(waitPoint);
+                this.dispatchAction({ action: "wait", suspension: suspension });
+            }
+        }
+    }
+
+    private getCurrentPlayerState(): IMediaPlayerState {
+        if (!this._requestPlayerStateHandler) {
+            throw new Error(
+                `SharedMediaSession: no getPlayerState callback configured.`
+            );
+        }
+
+        return this._requestPlayerStateHandler();
+    }
+
+    private dispatchAction(
+        details: MediaSessionActionDetails | ExtendedMediaSessionActionDetails
+    ): void {
+        if (this._actionHandlers.has(details.action)) {
+            const handler = this._actionHandlers.get(details.action);
+            this._actionThrottler.throttled(details, handler);
+        }
+    }
+}