VideoRTC.js

Class: splitAgent

splitAgent

SplitAgent usecase

new splitAgent(onEvents, domElements, options)

SplitAgent usecase

Parameters:
Name Type Description
onEvents object

Event handlers: onDestroyed, onError, onJoined, onDataReceived, onAcceptedVideo, onAcceptedData, onReadyLocalStream, onFileTransferOk, onFileTransferKo, onScreensharingAccepted, onScreensharingClosed, onNotified
domElements object

DOM elements: client, agent, screenRemote, screenLocal
options object

Available options: dataChannel, session, stream
Returns:

SplitAgent methods: getLicense, sendData, startRecording, startScreensharing, stopRecording, stopScreensharing, toggleVideo

Type
Promise
Example
var onEvents = {
    onDestroyed: function() {
         // Destroyed
    },
    onError: function(cause) {
         // Error
    },
    onJoined: function(screenRoom) {
         // Joined
    },
    onDataReceived: function(type, data, filename) {
        // Data received
        if(type === 'application/x-chat') { }
        else if(type === 'text/plain') { }
        else if(type === 'application/pdf') { }
        else if(type === 'application/zip') { }
        else if(type === 'application/x-rar') { }
        else if(type === 'image/jpeg') {}
        else if(type === 'image/png') {}
        else if(type === 'application/x-docx') {}
        else if(type === 'application/x-pptx') {}
        else if(type === 'application/x-xlsx') {}
        else if(type === 'application/vnd.oasis.opendocument.text') {}
    },
    onAcceptedVideo: function(stream) {
         // Accepted Video
    },
    onAcceptedData: function() {
         // Accepted Data
    },
    onReadyLocalStream: function(isReady) {
         // Local Video is ready
    },
    onScreensharingAccepted: function() {
         // ScreenSharing Accepted
    },
    onScreensharingClosed: function() {
         // ScreenSharing Closed
    },
    onFileTransferOk: function(fileId) {
         // File Transfer OK
    },
    onFileTransferKo: function(fileId) {
         // File Transfer KO
    },
    onNotified: function(action, data) {
         // Notification
    }
};

var domElements = {
    client: document.getElementById('clientvideo'),
    agent: document.getElementById('agentvideo'),
    screenRemote: document.getElementById('screenRemote'),
    screenLocal: document.getElementById('localscreen')
};

var options = {
     dataChannel: {
         dataEnabled: true,
         allowedTypes: ['application/x-chat', 'image/jpeg', 'image/png', 'application/pdf'],
         maxSize: 5, // In MB
         fileTransmission: {
             timeout: 5, // Minutes
             retransmissionDelay: 15 // Seconds
         }
     },
     session: {
         agentName: 'Anna',
         sessionId: 6655
     },
     stream: {
         videoEnabled: true,
         aDeviceId: null,
         vDeviceId: null,
         videoStream: null
     }
};

usecases.splitAgent(onEvents, domElements, options)
    .then(function(action) {
         // Use Case has been atacched succesfully
         ...
    })
    .catch(function(cause) {
        // Error attaching the Use Case
        console.log("Error Attach " + cause );
    })

Methods

<inner> closeUsecase()

Close the current UseCase. It's recommended combine with disconnect method

Returns:
Type
nothing
Example
action.closeUsecase();
myVideoApp.disconnect(); // Recommended

<inner> getLicense()

The VideoGateway is requested about the features of the contracted license

Returns:

License Information (Screensharing, Livechat and VideoRecording )

Type
Object
Example
var myLicense = action.getLicense();
console.log(myLicense);

<inner> notify(action, data)

Send a notification to the other peer via the VideoGateway

Parameters:
Name Type Description
action string

Identifies the notification type
data string

Useful for sending extra data (Optional)
Example
action.notify('open-map');

<inner> sendData(type, data, cOk, cKo, (Optional))

Sends a message (Chat or File) through the DataChannel

Parameters:
Name Type Description
type string

MIME Type (e.g: 'application/x-chat', 'text/plain', 'application/pdf', 'application/zip', 'application/x-rar', 'image/jpeg', 'image/png', 'application/x-docx', 'application/x-pptx', 'application/x-xlsx', 'application/vnd.oasis.opendocument.text')
data string

Data Content
cOk function

Callback success function
cKo function

Callback failed function
(Optional) string

filename File Name (e.g: file.zip)
Returns:
Type
nothing
Example
action.sendData('application/x-chat', 'Hello Mike!',
 function(cOk) {
     // Success
 },
 function(error) {
     // Error
     console.log(error);
 }
)

<inner> startRecording(recordPrefix)

The Agent sends a request to start recording the session

Parameters:
Name Type Description
recordPrefix string

Prefix of records: e.g: 'default'
Returns:
Type
nothing
Example
action.startRecording();

<inner> startScreensharing(screenId, cOk, cKo)

The Agent sends a request to start Screensharing

Parameters:
Name Type Description
screenId integer

Screen Id
cOk function

Callback Ok
cKo function

Callback Error
Returns:
Type
nothing
Example
action.startScreensharing(1234, function() {
     // Success
}, function(cause) {
     // Error
})

<inner> stopRecording()

The Agent sends a request to stop recording the session

Returns:
Type
nothing
Example
action.stopRecording();

<inner> stopScreensharing(cOk, cKo)

The Agent sends a request to stop Screensharing

Parameters:
Name Type Description
cOk function

Callback Ok
cKo function

Callback Error
Returns:
Type
nothing
Example
action.stopScreensharing(function() {
     // Success
}, function(cause) {
     // Error
})

<inner> toggleVideo()

Toggle local Video stream (Mute/Unmute)

Returns:

Is video muted?

Type
boolean
Example
action.toggleVideo(); // true or false