add subscriber name and default track state params

Author: burak-58

src/main/js/webrtc_adaptor.js

@@ -590,6 +590,58 @@ export class WebRTCAdaptor {
 		}
 		this.webSocketAdaptor.send(JSON.stringify(jsCmd));
 	}
+	
+	/**
+	 * Called to start a playing session for a stream. AMS responds with start message.
+	 * Parameters:
+	 *  @param {streamParameters} includes:
+	 *    {string} streamId :(string) unique id for the stream that you want to play
+	 *    {string=} token :(string) required if any stream security (token control) enabled. Check https://github.com/ant-media/Ant-Media-Server/wiki/Stream-Security-Documentation
+	 *    {string=} roomId :(string) required if this stream is belonging to a room participant
+	 *    {Array.<MediaStreamTrack>=} enableTracks :(array) required if the stream is a main stream of multitrack playing. You can pass the the subtrack id list that you want to play.
+	 *                    you can also provide a track id that you don't want to play by adding ! before the id.
+	 *    {string=} subscriberId :(string) required if TOTP enabled. Check https://github.com/ant-media/Ant-Media-Server/wiki/Time-based-One-Time-Password-(TOTP)
+	 *    {string=} subscriberName :(string) human readable name for subscriber
+	 *    {string=} subscriberCode :(string) required if TOTP enabled. Check https://github.com/ant-media/Ant-Media-Server/wiki/Time-based-One-Time-Password-(TOTP)
+	 *    {string=} metaData :(string, json) a free text information for the stream to AMS. It is provided to Rest methods by the AMS
+	 *    {string=} [role] : role for the stream. It is used for selective forwarding of subtracks in conference mode.
+	 *    {string=} [disableTracksByDefault] : disables tracks by default
+	 */
+	play(streamParameters) {
+		this.playStreamId.push(streamParameters.streamId);
+		this.playToken = streamParameters.token;
+		this.playRoomId = streamParameters.roomId;
+		this.playEnableTracks = streamParameters.enableTracks;
+		this.playSubscriberId = streamParameters.subscriberId;
+		this.playSubscriberName = streamParameters.subscriberName;
+		this.playSubscriberCode = streamParameters.subscriberCode;
+		this.playMetaData = streamParameters.metaData;
+		this.playRole = streamParameters.role;
+		this.disableTracksByDefault = streamParameters.disableTracksByDefault
+
+		let jsCmd =
+		{
+			command: "play",
+			streamId: streamParameters.streamId,
+			token: typeof streamParameters.token !== undefined && streamParameters.token != null ? streamParameters.token : "",
+			room: typeof streamParameters.roomId !== undefined && streamParameters.roomId != null ? streamParameters.roomId : "",
+			trackList: typeof streamParameters.enableTracks !== undefined && streamParameters.enableTracks != null ? streamParameters.enableTracks : [],
+			subscriberId: typeof streamParameters.subscriberId !== undefined && streamParameters.subscriberId != null ? streamParameters.subscriberId : "",
+			subscriberName: typeof streamParameters.subscriberName !== undefined && streamParameters.subscriberName != null ? streamParameters.subscriberName : "",
+			subscriberCode: typeof streamParameters.subscriberCode !== undefined && streamParameters.subscriberId != null ? streamParameters.subscriberCode : "",
+			viewerInfo: typeof streamParameters.metaData !== undefined && streamParameters.metaData != null ? streamParameters.metaData : "",
+			role: (typeof streamParameters.role !== undefined && streamParameters.role != null) ? streamParameters.role : "",
+			userPublishId: typeof this.publishStreamId !== undefined && this.publishStreamId != null ? this.publishStreamId : "",
+			disableTracksByDefault: typeof streamParameters.disableTracksByDefault !== undefined && streamParameters.disableTracksByDefault != null ? streamParameters.disableTracksByDefault : false,
+		}
+
+		this.webSocketAdaptor.send(JSON.stringify(jsCmd));
+
+		//init peer connection for reconnectIfRequired
+		this.initPeerConnection(streamParameters.streamId, streamParameters);
+		this.reconnectIfRequired(3000, false);
+	}
+	
 
 	/**
 	 * Called to start a playing session for a stream. AMS responds with start message.

src/test/js/webrtc_adaptor.test.js

@@ -2111,6 +2111,65 @@ describe("WebRTCAdaptor", function() {
     		webSocketAdaptor.expects("send").once().withArgs(JSON.stringify(jsCmd));
     		expect(initPeerConnection.calledWithExactly(streamId, "play")).to.be.true;
     	});
+		
+		it("Play with single parameter", async function() {
+		            let publishStreamId = "publish1"
+		            let streamId = "stream1";
+		            let token = "yourToken";
+		            let roomId = "yourRoomId";
+		            let enableTracks = true;
+		            let subscriberId = "yourSubscriberId";
+					let subscriberName = "yourSubscriberName";
+		            let subscriberCode = "yourSubscriberCode";
+		            let metaData = "yourMetaData";
+		            let role = "subscriber";
+					let disableTracksByDefault = true;
+
+		    		var adaptor = new WebRTCAdaptor({
+		    			websocketURL: "ws://example.com",
+		    			isPlayMode: true,
+		    			publishStreamId: publishStreamId
+		    		});
+
+		    		var peerConnection = new RTCPeerConnection();
+		            var initPeerConnection = sinon.replace(adaptor, "initPeerConnection", sinon.fake.returns(peerConnection));
+		    		var webSocketAdaptor = sinon.mock(adaptor.webSocketAdaptor);
+
+					
+					var playParameters;			
+					
+					playParameters.playStreamId = streamId;
+					playParameters.playToken = token;
+					playParameters.playRoomId = roomId;
+					playParameters.playEnableTracks = enableTracks;
+					playParameters.playSubscriberId = subscriberId;
+					playParameters.playSubscriberName = subscriberName;
+					playParameters.playSubscriberCode = subscriberCode;
+					playParameters.playMetaData = metaData;
+					playParameters.playRole = role;
+					playParameters.disableTracksByDefault = disableTracksByDefault
+
+					
+		            adaptor.play(playParameters);
+
+		            let jsCmd = {
+		                command: "play",
+		                streamId: streamId,
+		                token: token,
+		                room: roomId,
+		                trackList: enableTracks,
+		                subscriberId: subscriberId,
+						playSubscriberName: playSubscriberName,
+		                subscriberCode: subscriberCode,
+		                viewerInfo: metaData,
+		                role: role,
+		                userPublishId: publishStreamId,
+						disableTracksByDefault: disableTracksByDefault
+		            };
+
+		    		webSocketAdaptor.expects("send").once().withArgs(JSON.stringify(jsCmd));
+		    		expect(initPeerConnection.calledWithExactly(streamId, "play")).to.be.true;
+		    	});
 
 
 		it("getSubscriberCount", async function() {