@microsoft/live-share-media 1.0.0-preview.12 → 1.0.0-preview.14
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/bin/IMediaPlayer.d.ts +20 -20
- package/bin/IMediaPlayer.js +6 -6
- package/bin/LiveMediaSession.d.ts +95 -94
- package/bin/LiveMediaSession.d.ts.map +1 -1
- package/bin/LiveMediaSession.js +235 -231
- package/bin/LiveMediaSession.js.map +1 -1
- package/bin/LiveMediaSessionCoordinator.d.ts +238 -227
- package/bin/LiveMediaSessionCoordinator.d.ts.map +1 -1
- package/bin/LiveMediaSessionCoordinator.js +476 -407
- package/bin/LiveMediaSessionCoordinator.js.map +1 -1
- package/bin/LiveMediaSessionCoordinatorSuspension.d.ts +19 -19
- package/bin/LiveMediaSessionCoordinatorSuspension.js +27 -27
- package/bin/MediaPlayerSynchronizer.d.ts +173 -163
- package/bin/MediaPlayerSynchronizer.d.ts.map +1 -1
- package/bin/MediaPlayerSynchronizer.js +491 -468
- package/bin/MediaPlayerSynchronizer.js.map +1 -1
- package/bin/MediaSessionActionThrottler.d.ts +11 -11
- package/bin/MediaSessionActionThrottler.js +13 -13
- package/bin/MediaSessionExtensions.d.ts +34 -34
- package/bin/MediaSessionExtensions.d.ts.map +1 -1
- package/bin/MediaSessionExtensions.js +12 -12
- package/bin/RepeatedActionThrottler.d.ts +19 -19
- package/bin/RepeatedActionThrottler.js +62 -62
- package/bin/RepeatedActionThrottler.js.map +1 -1
- package/bin/VolumeManager.d.ts +83 -83
- package/bin/VolumeManager.js +174 -174
- package/bin/index.d.ts +13 -13
- package/bin/index.js +29 -29
- package/bin/internals/GroupCoordinatorState.d.ts +93 -92
- package/bin/internals/GroupCoordinatorState.d.ts.map +1 -1
- package/bin/internals/GroupCoordinatorState.js +407 -404
- package/bin/internals/GroupCoordinatorState.js.map +1 -1
- package/bin/internals/GroupPlaybackPosition.d.ts +67 -66
- package/bin/internals/GroupPlaybackPosition.d.ts.map +1 -1
- package/bin/internals/GroupPlaybackPosition.js +166 -166
- package/bin/internals/GroupPlaybackPosition.js.map +1 -1
- package/bin/internals/GroupPlaybackTrack.d.ts +45 -45
- package/bin/internals/GroupPlaybackTrack.d.ts.map +1 -1
- package/bin/internals/GroupPlaybackTrack.js +121 -121
- package/bin/internals/GroupPlaybackTrackData.d.ts +39 -39
- package/bin/internals/GroupPlaybackTrackData.d.ts.map +1 -1
- package/bin/internals/GroupPlaybackTrackData.js +69 -69
- package/bin/internals/GroupTransportState.d.ts +49 -48
- package/bin/internals/GroupTransportState.d.ts.map +1 -1
- package/bin/internals/GroupTransportState.js +111 -111
- package/bin/internals/GroupTransportState.js.map +1 -1
- package/bin/internals/consts.d.ts +75 -72
- package/bin/internals/consts.d.ts.map +1 -1
- package/bin/internals/consts.js +84 -81
- package/bin/internals/consts.js.map +1 -1
- package/bin/internals/index.d.ts +10 -10
- package/bin/internals/index.js +26 -26
- package/package.json +4 -4
- package/src/LiveMediaSession.ts +24 -12
- package/src/LiveMediaSessionCoordinator.ts +101 -29
- package/src/MediaPlayerSynchronizer.ts +30 -14
- package/src/internals/GroupCoordinatorState.ts +49 -35
- package/src/internals/GroupPlaybackPosition.ts +6 -2
- package/src/internals/GroupPlaybackTrack.ts +2 -2
- package/src/internals/GroupPlaybackTrackData.ts +2 -2
- package/src/internals/GroupTransportState.ts +11 -4
- package/src/internals/consts.ts +4 -0
- package/src/test/GroupPlaybackPosition.spec.ts +0 -600
- package/src/test/GroupPlaybackTrack.spec.ts +0 -122
- package/src/test/SharedMediaSession.spec.ts +0 -149
- package/src/test/SharedMediaSessionCoordinator.spec.ts +0 -271
- package/src/test/VolumeManager.spec.ts +0 -219
package/README.md
CHANGED
|
@@ -113,7 +113,7 @@ The Live Share SDK contains dependencies for [@microsoft/teams-js](https://www.n
|
|
|
113
113
|
|
|
114
114
|
| @microsoft/live-share | @microsoft/teams-js | fluid-framework | @microsoft/live-share-\* | @fluidframework/azure-client | @microsoft/TeamsFx | @microsoft/TeamsFx-react |
|
|
115
115
|
| --------------------- | -------------------- | --------------- | -------------------------- | ---------------------------- | ------------------------------- | ------------------------------- |
|
|
116
|
-
| 1.0.0-preview.
|
|
116
|
+
| 1.0.0-preview.14 | ^2.11.0 | ^1.2.3 | 1.0.0-preview.14 (optional) | ^1.0.0 (optional) | ^2.5.0 (optional) | ^2.5.0 (optional) |
|
|
117
117
|
| 1.0.0-preview.10 | ^2.10.1 | ~1.2.3 | 1.0.0-preview.10 (optional) | ~1.0.2 (optional) | ^2.5.0 (optional) | ^2.5.0 (optional) |
|
|
118
118
|
| 1.0.0-preview.8 | ^2.5.0 | ~1.2.3 | 1.0.0-preview.10 (optional) | ~1.0.2 (optional) | ^2.5.0 (optional) | ^2.5.0 (optional) |
|
|
119
119
|
| 1.0.0-preview.3 | 2.0.0-experimental.1 | ~1.2.3 | 1.0.0-preview.3 (optional) | ~1.0.2 (optional) | 2.0.0-experimental.0 (optional) | 2.0.0-experimental.0 (optional) |
|
package/bin/IMediaPlayer.d.ts
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Copyright (c) Microsoft Corporation. All rights reserved.
|
|
3
|
-
* Licensed under the Microsoft Live Share SDK License.
|
|
4
|
-
*/
|
|
5
|
-
export interface IMediaPlayer {
|
|
6
|
-
readonly currentSrc: string;
|
|
7
|
-
currentTime: number;
|
|
8
|
-
readonly duration: number;
|
|
9
|
-
readonly ended: boolean;
|
|
10
|
-
muted: boolean;
|
|
11
|
-
readonly paused: boolean;
|
|
12
|
-
playbackRate: number;
|
|
13
|
-
src: string;
|
|
14
|
-
volume: number;
|
|
15
|
-
load(): void;
|
|
16
|
-
pause(): void;
|
|
17
|
-
play(): Promise<void>;
|
|
18
|
-
addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
|
|
19
|
-
removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
|
|
20
|
-
}
|
|
1
|
+
/**
|
|
2
|
+
* Copyright (c) Microsoft Corporation. All rights reserved.
|
|
3
|
+
* Licensed under the Microsoft Live Share SDK License.
|
|
4
|
+
*/
|
|
5
|
+
export interface IMediaPlayer {
|
|
6
|
+
readonly currentSrc: string;
|
|
7
|
+
currentTime: number;
|
|
8
|
+
readonly duration: number;
|
|
9
|
+
readonly ended: boolean;
|
|
10
|
+
muted: boolean;
|
|
11
|
+
readonly paused: boolean;
|
|
12
|
+
playbackRate: number;
|
|
13
|
+
src: string;
|
|
14
|
+
volume: number;
|
|
15
|
+
load(): void;
|
|
16
|
+
pause(): void;
|
|
17
|
+
play(): Promise<void>;
|
|
18
|
+
addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
|
|
19
|
+
removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
|
|
20
|
+
}
|
|
21
21
|
//# sourceMappingURL=IMediaPlayer.d.ts.map
|
package/bin/IMediaPlayer.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
/**
|
|
3
|
-
* Copyright (c) Microsoft Corporation. All rights reserved.
|
|
4
|
-
* Licensed under the Microsoft Live Share SDK License.
|
|
5
|
-
*/
|
|
6
|
-
Object.defineProperty(exports, "__esModule", { value: true });
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* Copyright (c) Microsoft Corporation. All rights reserved.
|
|
4
|
+
* Licensed under the Microsoft Live Share SDK License.
|
|
5
|
+
*/
|
|
6
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
7
7
|
//# sourceMappingURL=IMediaPlayer.js.map
|
|
@@ -1,95 +1,96 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Copyright (c) Microsoft Corporation. All rights reserved.
|
|
3
|
-
* Licensed under the Microsoft Live Share SDK License.
|
|
4
|
-
*/
|
|
5
|
-
import {
|
|
6
|
-
import { LiveTelemetryLogger, UserMeetingRole } from "@microsoft/live-share";
|
|
7
|
-
import { MediaPlayerSynchronizer } from "./MediaPlayerSynchronizer";
|
|
8
|
-
import { ExtendedMediaSessionAction } from "./MediaSessionExtensions";
|
|
9
|
-
import { LiveMediaSessionCoordinator, IMediaPlayerState } from "./LiveMediaSessionCoordinator";
|
|
10
|
-
import { MediaSessionActionThrottler } from "./MediaSessionActionThrottler";
|
|
11
|
-
import { IMediaPlayer } from "./IMediaPlayer";
|
|
12
|
-
/**
|
|
13
|
-
* Live fluid object that synchronizes media playback across multiple clients.
|
|
14
|
-
*/
|
|
15
|
-
export declare class LiveMediaSession extends
|
|
16
|
-
private _actionThrottler;
|
|
17
|
-
private _logger?;
|
|
18
|
-
private _requestPlayerStateHandler?;
|
|
19
|
-
private _coordinator?;
|
|
20
|
-
private readonly _actionHandlers;
|
|
21
|
-
private _synchronizing?;
|
|
22
|
-
private _updateTimer;
|
|
23
|
-
private _lastUpdateTime;
|
|
24
|
-
/**
|
|
25
|
-
* The objects fluid type name.
|
|
26
|
-
*/
|
|
27
|
-
static readonly TypeName = "@microsoft/fluid-media:SharedMediaSession";
|
|
28
|
-
/**
|
|
29
|
-
* The objects fluid type factory.
|
|
30
|
-
*/
|
|
31
|
-
static readonly factory: DataObjectFactory<LiveMediaSession, import("@fluidframework/aqueduct").DataObjectTypes>;
|
|
32
|
-
/**
|
|
33
|
-
* Extension point that lets applications replace the default logic for throttling the sessions
|
|
34
|
-
* local sync behavior.
|
|
35
|
-
*
|
|
36
|
-
* @remarks
|
|
37
|
-
* The `LiveMediaCoordinator` is fairly aggressive at wanting to keep the local media player
|
|
38
|
-
* in sync with the rest of the group. This aggressiveness can result in the coordinator sending
|
|
39
|
-
* new sync actions before the local player has finished responding to the previous sync action.
|
|
40
|
-
* The `ActionThrottler` gives apps fine grain control over how aggressive they want sync to be.
|
|
41
|
-
*
|
|
42
|
-
* By default, a `RepeatedAction` throttler is used which prevents the same sync action from
|
|
43
|
-
* being sent within an adjustable time period.
|
|
44
|
-
*/
|
|
45
|
-
get actionThrottler(): MediaSessionActionThrottler;
|
|
46
|
-
set actionThrottler(value: MediaSessionActionThrottler);
|
|
47
|
-
/**
|
|
48
|
-
* Returns true if the object has been initialized.
|
|
49
|
-
*/
|
|
50
|
-
get isInitialized(): boolean;
|
|
51
|
-
/**
|
|
52
|
-
* @deprecated isInitialized should be used instead
|
|
53
|
-
* Returns true if the object has been initialized.
|
|
54
|
-
*/
|
|
55
|
-
get isStarted(): boolean;
|
|
56
|
-
/**
|
|
57
|
-
* The group coordinator for the session.
|
|
58
|
-
*/
|
|
59
|
-
get coordinator(): LiveMediaSessionCoordinator;
|
|
60
|
-
/**
|
|
61
|
-
* Returns the logger used by the session and coordinator.
|
|
62
|
-
*
|
|
63
|
-
* @remarks
|
|
64
|
-
* This is used by the `MediaPlayerSynchronizer` to log events.
|
|
65
|
-
*/
|
|
66
|
-
get logger(): LiveTelemetryLogger;
|
|
67
|
-
/**
|
|
68
|
-
* initialize the object.
|
|
69
|
-
* @param
|
|
70
|
-
* operations like play/pause/seek/setTrack.
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
*
|
|
76
|
-
* @param
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
*
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
*
|
|
87
|
-
* @
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
private
|
|
93
|
-
private
|
|
94
|
-
|
|
1
|
+
/**
|
|
2
|
+
* Copyright (c) Microsoft Corporation. All rights reserved.
|
|
3
|
+
* Licensed under the Microsoft Live Share SDK License.
|
|
4
|
+
*/
|
|
5
|
+
import { DataObjectFactory } from "@fluidframework/aqueduct";
|
|
6
|
+
import { LiveDataObject, LiveTelemetryLogger, UserMeetingRole } from "@microsoft/live-share";
|
|
7
|
+
import { MediaPlayerSynchronizer } from "./MediaPlayerSynchronizer";
|
|
8
|
+
import { ExtendedMediaSessionAction } from "./MediaSessionExtensions";
|
|
9
|
+
import { LiveMediaSessionCoordinator, IMediaPlayerState } from "./LiveMediaSessionCoordinator";
|
|
10
|
+
import { MediaSessionActionThrottler } from "./MediaSessionActionThrottler";
|
|
11
|
+
import { IMediaPlayer } from "./IMediaPlayer";
|
|
12
|
+
/**
|
|
13
|
+
* Live fluid object that synchronizes media playback across multiple clients.
|
|
14
|
+
*/
|
|
15
|
+
export declare class LiveMediaSession extends LiveDataObject {
|
|
16
|
+
private _actionThrottler;
|
|
17
|
+
private _logger?;
|
|
18
|
+
private _requestPlayerStateHandler?;
|
|
19
|
+
private _coordinator?;
|
|
20
|
+
private readonly _actionHandlers;
|
|
21
|
+
private _synchronizing?;
|
|
22
|
+
private _updateTimer;
|
|
23
|
+
private _lastUpdateTime;
|
|
24
|
+
/**
|
|
25
|
+
* The objects fluid type name.
|
|
26
|
+
*/
|
|
27
|
+
static readonly TypeName = "@microsoft/fluid-media:SharedMediaSession";
|
|
28
|
+
/**
|
|
29
|
+
* The objects fluid type factory.
|
|
30
|
+
*/
|
|
31
|
+
static readonly factory: DataObjectFactory<LiveMediaSession, import("@fluidframework/aqueduct").DataObjectTypes>;
|
|
32
|
+
/**
|
|
33
|
+
* Extension point that lets applications replace the default logic for throttling the sessions
|
|
34
|
+
* local sync behavior.
|
|
35
|
+
*
|
|
36
|
+
* @remarks
|
|
37
|
+
* The `LiveMediaCoordinator` is fairly aggressive at wanting to keep the local media player
|
|
38
|
+
* in sync with the rest of the group. This aggressiveness can result in the coordinator sending
|
|
39
|
+
* new sync actions before the local player has finished responding to the previous sync action.
|
|
40
|
+
* The `ActionThrottler` gives apps fine grain control over how aggressive they want sync to be.
|
|
41
|
+
*
|
|
42
|
+
* By default, a `RepeatedAction` throttler is used which prevents the same sync action from
|
|
43
|
+
* being sent within an adjustable time period.
|
|
44
|
+
*/
|
|
45
|
+
get actionThrottler(): MediaSessionActionThrottler;
|
|
46
|
+
set actionThrottler(value: MediaSessionActionThrottler);
|
|
47
|
+
/**
|
|
48
|
+
* Returns true if the object has been initialized.
|
|
49
|
+
*/
|
|
50
|
+
get isInitialized(): boolean;
|
|
51
|
+
/**
|
|
52
|
+
* @deprecated isInitialized should be used instead
|
|
53
|
+
* Returns true if the object has been initialized.
|
|
54
|
+
*/
|
|
55
|
+
get isStarted(): boolean;
|
|
56
|
+
/**
|
|
57
|
+
* The group coordinator for the session.
|
|
58
|
+
*/
|
|
59
|
+
get coordinator(): LiveMediaSessionCoordinator;
|
|
60
|
+
/**
|
|
61
|
+
* Returns the logger used by the session and coordinator.
|
|
62
|
+
*
|
|
63
|
+
* @remarks
|
|
64
|
+
* This is used by the `MediaPlayerSynchronizer` to log events.
|
|
65
|
+
*/
|
|
66
|
+
get logger(): LiveTelemetryLogger;
|
|
67
|
+
/**
|
|
68
|
+
* initialize the object.
|
|
69
|
+
* @param allowedRoles Optional. List of roles allowed to group transport
|
|
70
|
+
* operations like play/pause/seek/setTrack.
|
|
71
|
+
* @returns a void promise that resolves once complete
|
|
72
|
+
*/
|
|
73
|
+
initialize(allowedRoles?: UserMeetingRole[]): Promise<void>;
|
|
74
|
+
/**
|
|
75
|
+
* Registers an action handler with the session.
|
|
76
|
+
* @param action Name of the action to register a handler for.
|
|
77
|
+
* @param handler Function called when the action is triggered.
|
|
78
|
+
*/
|
|
79
|
+
setActionHandler(action: ExtendedMediaSessionAction, handler: MediaSessionActionHandler | null): void;
|
|
80
|
+
/**
|
|
81
|
+
* Registers a handler that will be queried anytime the group coordinate needs to know the
|
|
82
|
+
* local players transport state and position.
|
|
83
|
+
*/
|
|
84
|
+
setRequestPlayerStateHandler(handler: () => IMediaPlayerState): void;
|
|
85
|
+
/**
|
|
86
|
+
* Begins synchronizing the playback of a media element.
|
|
87
|
+
* @param player Something that "looks like" and HTML Media Element.
|
|
88
|
+
* @returns A new synchronizer instance. Call `synchronizer.end()` to stop synchronizing the elements playback.
|
|
89
|
+
*/
|
|
90
|
+
synchronize(player: IMediaPlayer): MediaPlayerSynchronizer;
|
|
91
|
+
protected hasInitialized(): Promise<void>;
|
|
92
|
+
private checkWaitPointHit;
|
|
93
|
+
private getCurrentPlayerState;
|
|
94
|
+
private dispatchAction;
|
|
95
|
+
}
|
|
95
96
|
//# sourceMappingURL=LiveMediaSession.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"LiveMediaSession.d.ts","sourceRoot":"","sources":["../src/LiveMediaSession.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,
|
|
1
|
+
{"version":3,"file":"LiveMediaSession.d.ts","sourceRoot":"","sources":["../src/LiveMediaSession.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAEH,cAAc,EACd,mBAAmB,EACnB,eAAe,EAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,OAAO,EAEH,0BAA0B,EAE7B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACH,2BAA2B,EAC3B,iBAAiB,EACpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAE5E,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAChD,OAAO,CAAC,gBAAgB,CACU;IAClC,OAAO,CAAC,OAAO,CAAC,CAAsB;IACtC,OAAO,CAAC,0BAA0B,CAAC,CAA0B;IAC7D,OAAO,CAAC,YAAY,CAAC,CAA8B;IACnD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAClB;IACd,OAAO,CAAC,cAAc,CAAC,CAA0B;IAGjD,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,eAAe,CAAa;IAEpC;;OAEG;IACH,gBAAuB,QAAQ,+CAA+C;IAE9E;;OAEG;IACH,gBAAuB,OAAO,0FAK5B;IAEF;;;;;;;;;;;;OAYG;IACH,IAAW,eAAe,IAAI,2BAA2B,CAExD;IAED,IAAW,eAAe,CAAC,KAAK,EAAE,2BAA2B,EAE5D;IAED;;OAEG;IACH,IAAW,aAAa,IAAI,OAAO,CAElC;IAED;;;OAGG;IACH,IAAW,SAAS,IAAI,OAAO,CAE9B;IAED;;OAEG;IACH,IAAW,WAAW,IAAI,2BAA2B,CAEpD;IAED;;;;;OAKG;IACH,IAAW,MAAM,IAAI,mBAAmB,CAEvC;IAED;;;;;OAKG;IACI,UAAU,CAAC,YAAY,CAAC,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlE;;;;OAIG;IACI,gBAAgB,CACnB,MAAM,EAAE,0BAA0B,EAClC,OAAO,EAAE,yBAAyB,GAAG,IAAI,GAC1C,IAAI;IAUP;;;OAGG;IACI,4BAA4B,CAAC,OAAO,EAAE,MAAM,iBAAiB;IAIpE;;;;OAIG;IACI,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,uBAAuB;cAoCjD,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IA2E/C,OAAO,CAAC,iBAAiB;IAuBzB,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,cAAc;CAQzB"}
|