io.openvidu.java.client

Class OpenVidu

java.lang.Object

io.openvidu.java.client.OpenVidu

public class OpenVidu
extends Object

Constructor Summary

Constructors

Constructor and Description
OpenVidu(String urlOpenViduServer, String secret)

Method Summary

Modifier and Type	Method and Description
Session	createSession() Creates an OpenVidu session with the default settings
Session	createSession(SessionProperties properties) Creates an OpenVidu session
void	deleteRecording(String recordingId) Deletes a recording.
Recording	getRecording(String recordingId) Gets an existing recording
List<Recording>	listRecordings() Lists all existing recordings
Recording	startRecording(String sessionId) Starts the recording of a Session
Recording	startRecording(String sessionId, RecordingProperties properties) Starts the recording of a Session
Recording	startRecording(String sessionId, String name) Starts the recording of a Session
Recording	stopRecording(String recordingId) Stops the recording of a Session

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

OpenVidu

public OpenVidu(String urlOpenViduServer,
                String secret)

Parameters:

urlOpenViduServer - Public accessible IP where your instance of OpenVidu Server is up an running

secret - Secret used on OpenVidu Server initialization

Method Detail

createSession

public Session createSession()
                      throws OpenViduJavaClientException,
                             OpenViduHttpException

Creates an OpenVidu session with the default settings

Returns:

The created session

Throws:

OpenViduJavaClientException

OpenViduHttpException

createSession

public Session createSession(SessionProperties properties)
                      throws OpenViduJavaClientException,
                             OpenViduHttpException

Creates an OpenVidu session

Parameters:

properties - The specific configuration for this session

Returns:

The created session

Throws:

OpenViduJavaClientException

OpenViduHttpException - Value returned from OpenViduHttpException.getStatus()

• 409: you are trying to assign an already-in-use custom sessionId to the session. See SessionProperties.customSessionId()

startRecording

public Recording startRecording(String sessionId,
                                RecordingProperties properties)
                         throws OpenViduJavaClientException,
                                OpenViduHttpException

Starts the recording of a Session

Parameters:

sessionId - The sessionId of the session you want to start recording

properties - The configuration for this recording

Returns:

The new created session

Throws:

OpenViduJavaClientException

OpenViduHttpException - Value returned from OpenViduHttpException.getStatus()

• 404: no session exists for the passed sessionId
• 400: the session has no connected participants
• 409: the session is not configured for using MediaMode.ROUTED or it is already being recorded
• 501: OpenVidu Server recording module is disabled (openvidu.recording property set to false)

startRecording

public Recording startRecording(String sessionId,
                                String name)
                         throws OpenViduJavaClientException,
                                OpenViduHttpException

Starts the recording of a Session

Parameters:

sessionId - The sessionId of the session you want to start recording

name - The name you want to give to the video file. You can access this same value in your clients on recording events (recordingStarted, recordingStopped)

Returns:

The started recording. If this method successfully returns the Recording object it means that the recording can be stopped with guarantees

Throws:

OpenViduJavaClientException

OpenViduHttpException - Value returned from OpenViduHttpException.getStatus()

• 404: no session exists for the passed sessionId
• 400: the session has no connected participants
• 409: the session is not configured for using MediaMode.ROUTED or it is already being recorded
• 501: OpenVidu Server recording module is disabled (openvidu.recording property set to false)

startRecording

public Recording startRecording(String sessionId)
                         throws OpenViduJavaClientException,
                                OpenViduHttpException

Starts the recording of a Session

Parameters:

sessionId - The sessionId of the session you want to start recording

Returns:

The started recording. If this method successfully returns the Recording object it means that the recording can be stopped with guarantees

Throws:

OpenViduJavaClientException

OpenViduHttpException - Value returned from OpenViduHttpException.getStatus()

• 404: no session exists for the passed sessionId
• 400: the session has no connected participants
• 409: the session is not configured for using MediaMode.ROUTED or it is already being recorded
• 501: OpenVidu Server recording module is disabled (openvidu.recording property set to false)

stopRecording

public Recording stopRecording(String recordingId)
                        throws OpenViduJavaClientException,
                               OpenViduHttpException

Stops the recording of a Session

Parameters:

recordingId - The id property of the recording you want to stop

Returns:

The stopped recording

Throws:

OpenViduJavaClientException

OpenViduHttpException - Value returned from OpenViduHttpException.getStatus()

• 404: no recording exists for the passed recordingId
• 406: recording has starting status. Wait until started status before stopping the recording

getRecording

public Recording getRecording(String recordingId)
                       throws OpenViduJavaClientException,
                              OpenViduHttpException

Gets an existing recording

Parameters:

recordingId - The id property of the recording you want to retrieve

Throws:

OpenViduJavaClientException

OpenViduHttpException - Value returned from OpenViduHttpException.getStatus()

• 404: no recording exists for the passed recordingId

listRecordings

public List<Recording> listRecordings()
                               throws OpenViduJavaClientException,
                                      OpenViduHttpException

Lists all existing recordings

Returns:

A List with all existing recordings

Throws:

OpenViduJavaClientException

OpenViduHttpException

deleteRecording

public void deleteRecording(String recordingId)
                     throws OpenViduJavaClientException,
                            OpenViduHttpException

Deletes a recording. The recording must have status Recording.Status.stopped or Recording.Status.available

Parameters:

recordingId -

Throws:

OpenViduJavaClientException

OpenViduHttpException - Value returned from OpenViduHttpException.getStatus()

• 404: no recording exists for the passed recordingId
• 409: the recording has started status. Stop it before deletion