@microsoft/live-share-media 0.5.0-beta → 0.5.0-beta.2
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/.nycrc.json +10 -10
- package/LICENSE +86 -86
- package/README.md +137 -137
- package/package.json +38 -38
- package/src/EphemeralMediaSession.ts +248 -248
- package/src/EphemeralMediaSessionCoordinator.ts +461 -461
- package/src/EphemeralMediaSessionCoordinatorSuspension.ts +30 -30
- package/src/IMediaPlayer.ts +21 -21
- package/src/MediaPlayerSynchronizer.ts +449 -449
- package/src/MediaSessionActionThrottler.ts +14 -14
- package/src/MediaSessionExtensions.ts +42 -42
- package/src/RepeatedActionThrottler.ts +55 -55
- package/src/VolumeLimiter.ts +181 -181
- package/src/index.ts +15 -15
- package/src/internals/GroupCoordinatorState.ts +445 -445
- package/src/internals/GroupPlaybackPosition.ts +193 -193
- package/src/internals/GroupPlaybackTrack.ts +147 -147
- package/src/internals/GroupPlaybackTrackData.ts +90 -90
- package/src/internals/GroupTransportState.ts +127 -127
- package/src/internals/consts.ts +80 -80
- package/src/internals/index.ts +10 -10
- package/src/test/GroupPlaybackPosition.spec.ts +339 -339
- package/src/test/GroupPlaybackTrack.spec.ts +65 -65
- package/src/test/SharedMediaSession.spec.ts +113 -113
- package/src/test/SharedMediaSessionCoordinator.spec.ts +230 -230
- package/tsconfig.build.json +8 -8
- package/tsconfig.json +75 -75
|
@@ -1,66 +1,66 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Copyright (c) Microsoft Corporation. All rights reserved.
|
|
3
|
-
* Licensed under the Microsoft Live Share SDK License.
|
|
4
|
-
*/
|
|
5
|
-
|
|
6
|
-
import 'mocha';
|
|
7
|
-
import { strict as assert } from 'assert';
|
|
8
|
-
import { IParticipant, ParticipantRole, Deferred } from '@microsoft/teams-collaboration';
|
|
9
|
-
import { GroupPlaybackTrack, GroupPlaybackTrackEvents, ITrackChangeEvent } from '../internals/GroupPlaybackTrack';
|
|
10
|
-
import { ExtendedMediaMetadata } from '../MediaSessionExtensions';
|
|
11
|
-
|
|
12
|
-
describe('GroupPlaybackTrack', () => {
|
|
13
|
-
const user1: IParticipant = { participantId: 'user1', role: ParticipantRole.organizer };
|
|
14
|
-
const user2: IParticipant = { participantId: 'user2', role: ParticipantRole.participant };
|
|
15
|
-
|
|
16
|
-
const track1 = { trackIdentifier: 'track1', title: 'Test Track 1' } as ExtendedMediaMetadata;
|
|
17
|
-
const track2 = { trackIdentifier: 'track2', title: 'Test Track 2' } as ExtendedMediaMetadata;
|
|
18
|
-
|
|
19
|
-
it('should fire "trackChange" event when no media', async () => {
|
|
20
|
-
const done = new Deferred();
|
|
21
|
-
const playbackTrack = new GroupPlaybackTrack(() => null);
|
|
22
|
-
playbackTrack.addEventListener(GroupPlaybackTrackEvents.trackChange, (event: ITrackChangeEvent) => {
|
|
23
|
-
try {
|
|
24
|
-
assert(event.metadata, `no metadata`);
|
|
25
|
-
assert(event.metadata.trackIdentifier == 'track1', `wrong track`);
|
|
26
|
-
done.resolve();
|
|
27
|
-
} catch(err) {
|
|
28
|
-
done.reject(err);
|
|
29
|
-
}
|
|
30
|
-
|
|
31
|
-
});
|
|
32
|
-
|
|
33
|
-
await playbackTrack.updateTrack({ metadata: track1, waitPoints: [], timestamp: 1, socketId: 'a'});
|
|
34
|
-
|
|
35
|
-
await done.promise;
|
|
36
|
-
});
|
|
37
|
-
|
|
38
|
-
it('should switch tracks', async () => {
|
|
39
|
-
let cnt = 0;
|
|
40
|
-
let metadata: ExtendedMediaMetadata = null;
|
|
41
|
-
const playbackTrack = new GroupPlaybackTrack(() => metadata);
|
|
42
|
-
playbackTrack.addEventListener(GroupPlaybackTrackEvents.trackChange, (event: ITrackChangeEvent) => {
|
|
43
|
-
cnt++;
|
|
44
|
-
metadata = event.metadata;
|
|
45
|
-
});
|
|
46
|
-
|
|
47
|
-
await playbackTrack.updateTrack({ metadata: track1, waitPoints: [], timestamp: 1, socketId: 'a'});
|
|
48
|
-
await playbackTrack.updateTrack({ metadata: track2, waitPoints: [], timestamp: 2, socketId: 'b'});
|
|
49
|
-
assert(cnt == 2, `called trackChange event ${cnt} times`);
|
|
50
|
-
assert(metadata.trackIdentifier == 'track2', `wrong track set`);
|
|
51
|
-
});
|
|
52
|
-
|
|
53
|
-
it('should ignore track changes with older timestamps', async () => {
|
|
54
|
-
let cnt = 0;
|
|
55
|
-
let metadata: ExtendedMediaMetadata = null;
|
|
56
|
-
const playbackTrack = new GroupPlaybackTrack(() => metadata);
|
|
57
|
-
playbackTrack.addEventListener(GroupPlaybackTrackEvents.trackChange, (event: ITrackChangeEvent) => {
|
|
58
|
-
cnt++;
|
|
59
|
-
metadata = event.metadata;
|
|
60
|
-
});
|
|
61
|
-
|
|
62
|
-
await playbackTrack.updateTrack({ metadata: track1, waitPoints: [], timestamp: 3, socketId: 'a'});
|
|
63
|
-
await playbackTrack.updateTrack({ metadata: track2, waitPoints: [], timestamp: 2, socketId: 'b'});
|
|
64
|
-
assert(cnt == 1, `called trackChange event ${cnt} times`);
|
|
65
|
-
});
|
|
1
|
+
/**
|
|
2
|
+
* Copyright (c) Microsoft Corporation. All rights reserved.
|
|
3
|
+
* Licensed under the Microsoft Live Share SDK License.
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
import 'mocha';
|
|
7
|
+
import { strict as assert } from 'assert';
|
|
8
|
+
import { IParticipant, ParticipantRole, Deferred } from '@microsoft/teams-collaboration';
|
|
9
|
+
import { GroupPlaybackTrack, GroupPlaybackTrackEvents, ITrackChangeEvent } from '../internals/GroupPlaybackTrack';
|
|
10
|
+
import { ExtendedMediaMetadata } from '../MediaSessionExtensions';
|
|
11
|
+
|
|
12
|
+
describe('GroupPlaybackTrack', () => {
|
|
13
|
+
const user1: IParticipant = { participantId: 'user1', role: ParticipantRole.organizer };
|
|
14
|
+
const user2: IParticipant = { participantId: 'user2', role: ParticipantRole.participant };
|
|
15
|
+
|
|
16
|
+
const track1 = { trackIdentifier: 'track1', title: 'Test Track 1' } as ExtendedMediaMetadata;
|
|
17
|
+
const track2 = { trackIdentifier: 'track2', title: 'Test Track 2' } as ExtendedMediaMetadata;
|
|
18
|
+
|
|
19
|
+
it('should fire "trackChange" event when no media', async () => {
|
|
20
|
+
const done = new Deferred();
|
|
21
|
+
const playbackTrack = new GroupPlaybackTrack(() => null);
|
|
22
|
+
playbackTrack.addEventListener(GroupPlaybackTrackEvents.trackChange, (event: ITrackChangeEvent) => {
|
|
23
|
+
try {
|
|
24
|
+
assert(event.metadata, `no metadata`);
|
|
25
|
+
assert(event.metadata.trackIdentifier == 'track1', `wrong track`);
|
|
26
|
+
done.resolve();
|
|
27
|
+
} catch(err) {
|
|
28
|
+
done.reject(err);
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
});
|
|
32
|
+
|
|
33
|
+
await playbackTrack.updateTrack({ metadata: track1, waitPoints: [], timestamp: 1, socketId: 'a'});
|
|
34
|
+
|
|
35
|
+
await done.promise;
|
|
36
|
+
});
|
|
37
|
+
|
|
38
|
+
it('should switch tracks', async () => {
|
|
39
|
+
let cnt = 0;
|
|
40
|
+
let metadata: ExtendedMediaMetadata = null;
|
|
41
|
+
const playbackTrack = new GroupPlaybackTrack(() => metadata);
|
|
42
|
+
playbackTrack.addEventListener(GroupPlaybackTrackEvents.trackChange, (event: ITrackChangeEvent) => {
|
|
43
|
+
cnt++;
|
|
44
|
+
metadata = event.metadata;
|
|
45
|
+
});
|
|
46
|
+
|
|
47
|
+
await playbackTrack.updateTrack({ metadata: track1, waitPoints: [], timestamp: 1, socketId: 'a'});
|
|
48
|
+
await playbackTrack.updateTrack({ metadata: track2, waitPoints: [], timestamp: 2, socketId: 'b'});
|
|
49
|
+
assert(cnt == 2, `called trackChange event ${cnt} times`);
|
|
50
|
+
assert(metadata.trackIdentifier == 'track2', `wrong track set`);
|
|
51
|
+
});
|
|
52
|
+
|
|
53
|
+
it('should ignore track changes with older timestamps', async () => {
|
|
54
|
+
let cnt = 0;
|
|
55
|
+
let metadata: ExtendedMediaMetadata = null;
|
|
56
|
+
const playbackTrack = new GroupPlaybackTrack(() => metadata);
|
|
57
|
+
playbackTrack.addEventListener(GroupPlaybackTrackEvents.trackChange, (event: ITrackChangeEvent) => {
|
|
58
|
+
cnt++;
|
|
59
|
+
metadata = event.metadata;
|
|
60
|
+
});
|
|
61
|
+
|
|
62
|
+
await playbackTrack.updateTrack({ metadata: track1, waitPoints: [], timestamp: 3, socketId: 'a'});
|
|
63
|
+
await playbackTrack.updateTrack({ metadata: track2, waitPoints: [], timestamp: 2, socketId: 'b'});
|
|
64
|
+
assert(cnt == 1, `called trackChange event ${cnt} times`);
|
|
65
|
+
});
|
|
66
66
|
});
|
|
@@ -1,113 +1,113 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Copyright (c) Microsoft Corporation. All rights reserved.
|
|
3
|
-
* Licensed under the Microsoft Live Share SDK License.
|
|
4
|
-
*/
|
|
5
|
-
|
|
6
|
-
import 'mocha';
|
|
7
|
-
import { strict as assert } from 'assert';
|
|
8
|
-
import { CollaborationSpace, CollaborationSpaceEvents, Deferred } from '@microsoft/teams-collaboration';
|
|
9
|
-
import { LastMediaPositionState } from '../EphemeralMediaSessionCoordinator';
|
|
10
|
-
import { ExtendedMediaMetadata, ExtendedMediaSessionActionDetails } from '../MediaSessionExtensions';
|
|
11
|
-
import { SharedMediaSession } from '../EphemeralMediaSession';
|
|
12
|
-
|
|
13
|
-
export class TestMediaSession extends SharedMediaSession {
|
|
14
|
-
private done = new Deferred<ExtendedMediaSessionActionDetails>();
|
|
15
|
-
private space: CollaborationSpace;
|
|
16
|
-
private playbackTimer: any;
|
|
17
|
-
private playbackStarted: number = 0;
|
|
18
|
-
private playbackPosition: number = 0.0;
|
|
19
|
-
|
|
20
|
-
constructor(space: CollaborationSpace, metadata?: ExtendedMediaMetadata|null, playbackState?: MediaSessionPlaybackState, positionState?: LastMediaPositionState) {
|
|
21
|
-
super(space);
|
|
22
|
-
this.space = space;
|
|
23
|
-
if (metadata) { this.metadata = metadata; }
|
|
24
|
-
if (playbackState) { this.playbackState = playbackState; }
|
|
25
|
-
if (positionState) {
|
|
26
|
-
this.playbackPosition = positionState.position != undefined ? positionState.position : 0.0;
|
|
27
|
-
this.duration = positionState.duration;
|
|
28
|
-
this.playbackRate = positionState.playbackRate != undefined ? positionState.playbackRate : 1;
|
|
29
|
-
}
|
|
30
|
-
|
|
31
|
-
this.setActionHandler('play', details => {
|
|
32
|
-
this.play();
|
|
33
|
-
this.done.resolve(details);
|
|
34
|
-
});
|
|
35
|
-
this.setActionHandler('pause', details => {
|
|
36
|
-
this.pause();
|
|
37
|
-
this.done.resolve(details);
|
|
38
|
-
});
|
|
39
|
-
this.setActionHandler('seekto', details => {
|
|
40
|
-
this.currentTime = details.seekTime;
|
|
41
|
-
this.done.resolve(details);
|
|
42
|
-
});
|
|
43
|
-
this.setActionHandler('settrack', details => {
|
|
44
|
-
this.done.resolve(details);
|
|
45
|
-
});
|
|
46
|
-
|
|
47
|
-
this.space.addEventListener(CollaborationSpaceEvents.leftSpace, () => {
|
|
48
|
-
if (this.playbackTimer) {
|
|
49
|
-
clearInterval(this.playbackTimer);
|
|
50
|
-
this.playbackTimer = undefined;
|
|
51
|
-
}
|
|
52
|
-
});
|
|
53
|
-
}
|
|
54
|
-
|
|
55
|
-
public duration?: number;
|
|
56
|
-
public playbackRate: number = 1;
|
|
57
|
-
|
|
58
|
-
public get playing(): boolean {
|
|
59
|
-
return this.playbackState == 'playing';
|
|
60
|
-
}
|
|
61
|
-
|
|
62
|
-
public get paused(): boolean {
|
|
63
|
-
return this.playbackState != 'playing';
|
|
64
|
-
}
|
|
65
|
-
|
|
66
|
-
public get currentTime(): number {
|
|
67
|
-
if (this.playbackState == 'playing') {
|
|
68
|
-
const now = this.space.clock.getTime();
|
|
69
|
-
return this.playbackPosition + ((now - this.playbackStarted) / 1000);
|
|
70
|
-
} else {
|
|
71
|
-
return this.playbackPosition;
|
|
72
|
-
}
|
|
73
|
-
}
|
|
74
|
-
|
|
75
|
-
public set currentTime(value: number) {
|
|
76
|
-
const startState = this.playbackState;
|
|
77
|
-
this.pause();
|
|
78
|
-
this.playbackPosition = value;
|
|
79
|
-
if (startState == 'playing') {
|
|
80
|
-
this.play();
|
|
81
|
-
} else {
|
|
82
|
-
this.setPositionState({position: this.currentTime, duration: this.duration, playbackRate: this.playbackRate});
|
|
83
|
-
}
|
|
84
|
-
}
|
|
85
|
-
|
|
86
|
-
public play(): void {
|
|
87
|
-
if (this.playbackState != 'playing') {
|
|
88
|
-
this.playbackStarted = this.space.clock.getTime();
|
|
89
|
-
this.playbackState = 'playing';
|
|
90
|
-
this.playbackTimer = setInterval(() => {
|
|
91
|
-
this.playbackState = 'playing';
|
|
92
|
-
this.setPositionState({position: this.currentTime, duration: this.duration, playbackRate: this.playbackRate});
|
|
93
|
-
}, 60);
|
|
94
|
-
}
|
|
95
|
-
}
|
|
96
|
-
|
|
97
|
-
public pause(): void {
|
|
98
|
-
if (this.playbackTimer) {
|
|
99
|
-
clearInterval(this.playbackTimer);
|
|
100
|
-
this.playbackTimer = undefined;
|
|
101
|
-
}
|
|
102
|
-
|
|
103
|
-
this.playbackPosition = this.currentTime;
|
|
104
|
-
this.playbackState = 'paused';
|
|
105
|
-
this.setPositionState({position: this.currentTime, duration: this.duration, playbackRate: this.playbackRate});
|
|
106
|
-
}
|
|
107
|
-
|
|
108
|
-
public async waitForAction(handler: (details: ExtendedMediaSessionActionDetails) => Promise<void>): Promise<void> {
|
|
109
|
-
const details = await this.done.promise;
|
|
110
|
-
this.done = new Deferred<ExtendedMediaSessionActionDetails>();
|
|
111
|
-
await handler(details);
|
|
112
|
-
}
|
|
113
|
-
}
|
|
1
|
+
/**
|
|
2
|
+
* Copyright (c) Microsoft Corporation. All rights reserved.
|
|
3
|
+
* Licensed under the Microsoft Live Share SDK License.
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
import 'mocha';
|
|
7
|
+
import { strict as assert } from 'assert';
|
|
8
|
+
import { CollaborationSpace, CollaborationSpaceEvents, Deferred } from '@microsoft/teams-collaboration';
|
|
9
|
+
import { LastMediaPositionState } from '../EphemeralMediaSessionCoordinator';
|
|
10
|
+
import { ExtendedMediaMetadata, ExtendedMediaSessionActionDetails } from '../MediaSessionExtensions';
|
|
11
|
+
import { SharedMediaSession } from '../EphemeralMediaSession';
|
|
12
|
+
|
|
13
|
+
export class TestMediaSession extends SharedMediaSession {
|
|
14
|
+
private done = new Deferred<ExtendedMediaSessionActionDetails>();
|
|
15
|
+
private space: CollaborationSpace;
|
|
16
|
+
private playbackTimer: any;
|
|
17
|
+
private playbackStarted: number = 0;
|
|
18
|
+
private playbackPosition: number = 0.0;
|
|
19
|
+
|
|
20
|
+
constructor(space: CollaborationSpace, metadata?: ExtendedMediaMetadata|null, playbackState?: MediaSessionPlaybackState, positionState?: LastMediaPositionState) {
|
|
21
|
+
super(space);
|
|
22
|
+
this.space = space;
|
|
23
|
+
if (metadata) { this.metadata = metadata; }
|
|
24
|
+
if (playbackState) { this.playbackState = playbackState; }
|
|
25
|
+
if (positionState) {
|
|
26
|
+
this.playbackPosition = positionState.position != undefined ? positionState.position : 0.0;
|
|
27
|
+
this.duration = positionState.duration;
|
|
28
|
+
this.playbackRate = positionState.playbackRate != undefined ? positionState.playbackRate : 1;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
this.setActionHandler('play', details => {
|
|
32
|
+
this.play();
|
|
33
|
+
this.done.resolve(details);
|
|
34
|
+
});
|
|
35
|
+
this.setActionHandler('pause', details => {
|
|
36
|
+
this.pause();
|
|
37
|
+
this.done.resolve(details);
|
|
38
|
+
});
|
|
39
|
+
this.setActionHandler('seekto', details => {
|
|
40
|
+
this.currentTime = details.seekTime;
|
|
41
|
+
this.done.resolve(details);
|
|
42
|
+
});
|
|
43
|
+
this.setActionHandler('settrack', details => {
|
|
44
|
+
this.done.resolve(details);
|
|
45
|
+
});
|
|
46
|
+
|
|
47
|
+
this.space.addEventListener(CollaborationSpaceEvents.leftSpace, () => {
|
|
48
|
+
if (this.playbackTimer) {
|
|
49
|
+
clearInterval(this.playbackTimer);
|
|
50
|
+
this.playbackTimer = undefined;
|
|
51
|
+
}
|
|
52
|
+
});
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
public duration?: number;
|
|
56
|
+
public playbackRate: number = 1;
|
|
57
|
+
|
|
58
|
+
public get playing(): boolean {
|
|
59
|
+
return this.playbackState == 'playing';
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
public get paused(): boolean {
|
|
63
|
+
return this.playbackState != 'playing';
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
public get currentTime(): number {
|
|
67
|
+
if (this.playbackState == 'playing') {
|
|
68
|
+
const now = this.space.clock.getTime();
|
|
69
|
+
return this.playbackPosition + ((now - this.playbackStarted) / 1000);
|
|
70
|
+
} else {
|
|
71
|
+
return this.playbackPosition;
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
public set currentTime(value: number) {
|
|
76
|
+
const startState = this.playbackState;
|
|
77
|
+
this.pause();
|
|
78
|
+
this.playbackPosition = value;
|
|
79
|
+
if (startState == 'playing') {
|
|
80
|
+
this.play();
|
|
81
|
+
} else {
|
|
82
|
+
this.setPositionState({position: this.currentTime, duration: this.duration, playbackRate: this.playbackRate});
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
public play(): void {
|
|
87
|
+
if (this.playbackState != 'playing') {
|
|
88
|
+
this.playbackStarted = this.space.clock.getTime();
|
|
89
|
+
this.playbackState = 'playing';
|
|
90
|
+
this.playbackTimer = setInterval(() => {
|
|
91
|
+
this.playbackState = 'playing';
|
|
92
|
+
this.setPositionState({position: this.currentTime, duration: this.duration, playbackRate: this.playbackRate});
|
|
93
|
+
}, 60);
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
public pause(): void {
|
|
98
|
+
if (this.playbackTimer) {
|
|
99
|
+
clearInterval(this.playbackTimer);
|
|
100
|
+
this.playbackTimer = undefined;
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
this.playbackPosition = this.currentTime;
|
|
104
|
+
this.playbackState = 'paused';
|
|
105
|
+
this.setPositionState({position: this.currentTime, duration: this.duration, playbackRate: this.playbackRate});
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
public async waitForAction(handler: (details: ExtendedMediaSessionActionDetails) => Promise<void>): Promise<void> {
|
|
109
|
+
const details = await this.done.promise;
|
|
110
|
+
this.done = new Deferred<ExtendedMediaSessionActionDetails>();
|
|
111
|
+
await handler(details);
|
|
112
|
+
}
|
|
113
|
+
}
|