openvidu-java-client API


NOTE: all input parameters ("Parameters" columns) are listed in strict order, optional ones in italics

Class Description
OpenVidu Use it to create all the sessions you need
Session Allows for the creation of tokens
OpenViduRole Enum that defines the values accepted by TokenOptions.Builder.role(OpenViduRole role) method
TokenOptions Customize each token with this class when generating them

OpenVidu

Method Returns Parameters Description
OpenVidu() String:urlOpenViduServer
String:secret
The constructor receives the URL of your OpenVidu Server and the secret shared with it
createSession() Session Get a Session object by calling this method. You can then store it as you want

Session

Method Returns Parameters Description
getSessionId() String Returns the unique identifier of the session. You will need to return this parameter to the client side to pass it during the connection process to the session
generateToken() String TokenOptions:tokenOptions The value returned is required in the client side just as the sessionId in order to connect to a session

OpenViduRole

Enum Description
SUBSCRIBER They can subscribe to published streams of other users
PUBLISHER They can subscribe to published streams of other users and publish their own streams
MODERATOR They can subscribe to published streams of other users, publish their own streams and force unpublish() and disconnect() over a third-party stream or user

TokenOptions

Method Returns Parameters Description
getData() String Returns the metadata associated to the token
getRole() OpenViduRole Returns the role associated to the token
TokenOptions.Builder

(inner static class)

Method Returns Parameters Description
TokenOptions.Builder() Constructor
build() TokenOptions Returns a new TokenOptions object with the stablished properties. Default values if methods data() and role() are not called are an empty string and OpenViduRole.PUBLISHER, respectively
data() TokenOptions.Builder String:data Some extra metadata to be associated to the user through its token. The structure of this string is up to you (maybe some standarized format as JSON or XML is a good idea), the only restriction is a maximum length of 1000 chars
role() TokenOptions.Builder OpenViduRole:role The role associated to this token