# Getting started

# Installation

Using npm:

$ npm i @voicenter-team/opensips-js

# Usage

Firstly lets import the library and create the OpenSIPS instance:

import OpenSIPSJS from '@voicenter-team/opensips-js'

const openSIPSJS = new OpenSIPSJS({
    configuration: {
        session_timers: false,
        uri: 'sip:extension_user@domain',
        // --- Use password or authorization_jwt to authorize
        password: 'password',
        // or
        authorization_jwt: 'token',
    },
    socketInterfaces: [ 'wss://domain' ],
    pnExtraHeaders: {
        'pn-provider': 'acme',
        'pn-param': 'acme-param',
        'pn-prid': 'ZH11Y4ZDJlMNzODE1NgKi0K>'
    },
    sipDomain: 'domain',
    sipOptions: {
        session_timers: false,
        extraHeaders: [ 'X-Bar: bar' ],
        pcConfig: {},
    },
    modules: [ 'audio', 'video', 'msrp' ]
})

Then you can work with appropriate modules:

openSIPSJS.audio
openSIPSJS.video
openSIPSJS.msrp

# OpensipsJS

# OpensipsJS instance methods

begin(): OpensipsInstance - start opensips
on(event: OpensipsEvent, callback): void - remove event listener
subscribe({type: String, listener: function}): void - subscribe to an event. Available events: new_call, ended, progress, failed, confirmed
removeIListener(type: String): void - remove event listener

# OpensipsJS events

Event	Callback interface	Description
`ready`	`() => {}`	Emitted when opensips is initialized
`changeActiveCalls`	`(calls: { [key: string]: ICall }) => {}`	Emitted when active calls are changed
`callAddingInProgressChanged`	`(callId: string / undefined) => {}`	Emitted when any call adding state is changed
`changeAvailableDeviceList`	`(devices: Array<MediaDeviceInfo>) => {}`	Emitted when the list of available devices is changed
`changeActiveInputMediaDevice`	`(deviceId: string) => {}`	Emitted when active input device is changed
`changeActiveOutputMediaDevice`	`(deviceId: string) => {}`	Emitted when active output device is changed
`changeMuteWhenJoin`	`(value: boolean) => {}`	Emitted when mute on join value is changed
`changeIsDND`	`(value: boolean) => {}`	Emitted when is DND value is changed
`changeIsMuted`	`(value: boolean) => {}`	Emitted when mute value is changed
`changeActiveStream`	`(stream: MediaStream) => {}`	Emitted when active stream was changed
`changeCallVolume`	`(callId: string, volume: number) => {}`	Emits the volume meter's value for each participant
`currentActiveRoomChanged`	`(number / undefined) => {}`	Emitted when active room is changed
`addRoom`	`({room: IRoom, roomList: {[id: number]: IRoom}}) => {}`	Emitted when new room was added
`updateRoom`	`({room: IRoom, roomList: {[id: number]: IRoom}}) => {}`	Emitted when room was updated
`removeRoom`	`({room: IRoom, roomList: {[p: number]: IRoom}}) => {}`	Emitted when room was deleted

WebrtcMetricsConfigType

Parameter	Type	Default
`refreshEvery`	`number`	`undefined`
`startAfter`	`number`	`undefined`
`startAfter`	`number`	`undefined`
`verbose`	`boolean`	`undefined`
`pname`	`string`	`undefined`
`cid`	`string`	`undefined`
`uid`	`string`	`undefined`
`record`	`boolean`	`undefined`
`ticket`	`boolean`	`undefined`

Also, there are next public fields on OpensipsJS instance:

# OpensipsJS instance fields

sipDomain: String - returns sip domain

# Audio

# Audio methods

initCall(target: String, addToCurrentRoom: Boolean): void - call to the target. If addToCurrentRoom is true then the call will be added to the user's current room
holdCall(callId: String, automatic?: Boolean): Promise<void> - put call on hold
unholdCall(callId: String): Promise<void> - unhold a call
terminateCall(callId: String): void - terminate call
moveCall(callId: String, roomId: Number): Promise<void> - Same as callChangeRoom. Move call to the specific room
transferCall(callId: String, target: String): void - transfer call to target
mergeCall(roomId: Number): void - merge calls in specific room. Works only for rooms with 2 calls inside
answerCall(callId: String): void - answer a call
mute(): void - mute ourself
unmute(): void - unmute ourself
muteCaller(callId: String): void - mute caller
unmuteCaller(callId: String): void - unmute caller
setMicrophone(deviceId: String): Promise<void> - set passed device as input device for calls
setSpeaker(deviceId: String): Promise<void> - set passed device as output device for calls
setActiveRoom(roomId: Number): Promise<void> - switch to the room
setMicrophoneSensitivity(value: Number): void - set sensitivity of microphone. Value should be in range from 0 to 1
setSpeakerVolume(value: Number): void - set volume of callers. Value should be in range from 0 to 1
setDND(value: Boolean): void - set the agent "Do not disturb" status
setMetricsConfig(config: WebrtcMetricsConfigType): void - set the metric config (used for audio quality indicator)

# Audio instance fields

sipOptions: Object - returns sip options
getActiveRooms: { [key: number]: IRoom } - returns an object of active rooms where key is room id and value is room data
sipDomain: String - returns sip domain
sipOptions: Object - returns sip options
getInputDeviceList: [] - returns list of input devices
getOutputDeviceList: [] - returns list of output devices
currentActiveRoomId: Number - returns current active room id
selectedInputDevice: String - returns current selected input device id
selectedOutputDevice: String - returns current selected output device id
isDND: Boolean - returns if the agent is in "Do not disturb" status
isMuted: Boolean - returns if the agent is muted

# MSRP

# MSRP methods

initMSRP(target: String, body: String): void - initialize connection with target contact. Body is the initial message to this target.
sendMSRP(sessionId: String, body: String): Promise<void> - send message
msrpAnswer(sessionId: String) - accept MSRP session invitation
messageTerminate(sessionId: String) - terminate message session

# MSRP instance fields

getActiveMessages: { [key: string]: IMessage } - returns an object of active message sessions where key is session id and value is message session data.

# Video

# Video methods

joinRoom(roomId: String, displayName: String, mediaConstraints: Object): void - join conference room
hangup() - exit room
startVideo() - turn on camera
stopVideo() - turn off camera
startAudio() - mute
stopAudio() - unmute
startScreenShare() - start screen sharing
stopScreenShare() - stop screen sharing
enableScreenShareWhiteboard(enable: boolean, stream: MediaStream) - enable screen share whiteboard. stream parameter is screen share stream
enableBokehEffectMask(): Promise<MediaStream> - enable bokeh mask effect
enableBackgroundImgEffectMask(): Promise<MediaStream> - enable background image mask effect
disableMask(): Promise<MediaStream> - turn off mask effect. Returns stream without masking
restartMasking(): Promise<void> - rerun mask effect
setupMaskVisualizationConfig(config: VisualizationConfigType) - setup mask config
startNoiseFilter() - start noise filter
stopNoiseFilter() - stop noise filter
setBitrate(bitrate: number) - set bitrate for video
enableWhiteboard(mode: 'whiteboard' | 'imageWhiteboard', enable: boolean, base64Image?: string) - enable whiteboard. if mode is 'imageWhiteboard' then third parameter base64Image is required
setupDrawerOptions(options: KonvaDrawerOptions) - setup option for drawer
setupScreenShareDrawerOptions(options: KonvaScreenShareDrawerOptions) - setup option for screen share drawer

VisualizationConfigType

Parameter	Type	Default
`foregroundThreshold`	`number`	`0.5`
`maskOpacity`	`number`	`0.5`
`maskBlur`	`number`	`0`
`pixelCellWidth`	`number`	`10`
`backgroundBlur`	`number`	`15`
`edgeBlur`	`number`	`3`

KonvaDrawerOptions

Parameter	Type
`container`	`number`
`width`	`number`
`height`	`number`

KonvaScreenShareDrawerOptions

Parameter	Type
`strokeWidth`	`number`
`strokeColor`	`string`

# Video events

Event	Callback interface	Description
`member:join`	`(data) => {}`	Emitted when new member is joined
`member:update`	`(data) => {}`	Emitted when member data is changed
`member:hangup`	`(data) => {}`	Emitted when member leaves the conference
`hangup`	`() => {}`	Emitted when we leave the conference
`screenShare:start`	`() => {}`	Emitted when we share a screen
`screenShare:stop`	`() => {}`	Emitted when we stop a screen sharing
`reconnect`	`() => {}`	Emitted when reconnecting
`mediaConstraintsChange`	`() => {}`	Emitted when media constraints change
`metrics:report`	`() => {}`	Emitted on metric report
`metrics:stop`	`() => {}`	Emitted when metrics are stopped

← Project Overview Demo →