This article describes the VidyoReplay API functionality for the User and Admin API. The VidyoReplay API enables playing and recording of the video stream during the conference. The content management part enables accessing, deleting, renaming and changing the record contents.
VidyoReplay Service URL:
http://VIDYOPORTAL/services/v1_1/VidyoPortalUserService?wsdl
http://VIDYOPORTAL/services/v1_1/VidyoPortalAdminService?wsdl
VidyoReplay Content Management Service URL:
http://VIDYOPORTAL/replay/services/VidyoReplayContentManagementService?wsdl
The following methods are described in this article as part of the Guest API package.
GetRecordingProfiles
Provides the available recording profile. The recorder prefix defines the file format of the recording (CIF, CD, HD).
This method can use the following parameters:
Request Parameter
Name | Type | Description | Required |
---|---|---|---|
(Always Empty) |
N/A |
Use only the HTTP Authentication header |
N/A |
Response Parameters
Name | Type | Description | Required |
---|---|---|---|
total |
Integer |
Total number of profiles |
Yes |
recorderPrefix |
String |
Prefix ID |
Yes |
description |
String |
Prefix Description |
No |
Faults
Name | Description |
---|---|
GeneralFault | An unspecified error occurred |
InvalidArgumentFault |
The arguments that were passed into services were wrong |
NotLicensedFault |
API is not licensed |
SeatLicenseExpiredFault |
Seat license has expired and needs to be renewed |
startRecording
Starts the recording for a given participant (endpoint) in a conference.
This method can use the following parameters:
Request Parameters
Name | Type | Description | Required |
---|---|---|---|
conferenceID |
EntityID |
This is an ID for addressing the room object in the VidyoPortal where the conference is started |
Yes |
recorderPrefix |
String |
Prefix ID |
Yes |
webcast |
Boolean |
Start recording the webcast |
Yes |
Response Parameter
Name | Type | Description | Required |
---|---|---|---|
OK |
String |
Acknowledges that the operation was made successfully |
Yes |
Faults
Name | Description |
---|---|
GeneralFault | An unspecified error occurred |
InvalidArgumentFault |
The arguments that were passed into services were wrong |
NotLicensedFault |
API is not licensed |
ResourceNotAvailableFault |
Resource Not Available Fault |
SeatLicenseExpiredFault |
Seat license has expired and needs to be renewed |
StopRecording
Stops the recording for a given participant (endpoint) in a conference.
This method can use the following parameters:
Request Parameters
Name | Type | Description | Required |
---|---|---|---|
conferenceID |
EntityID |
This is an ID for addressing the room object in the VidyoPortal where the conference is started |
Yes |
recorderID |
String |
A string representing the recording prefix. The GetPArticipantsResponse() will provide recorderID associated with this conference. |
Yes |
Response Parameter
Name | Type | Description | Required |
---|---|---|---|
OK |
String |
Acknowledges that the operation was made successfully |
Yes |
Faults
Name | Description |
---|---|
GeneralFault | An unspecified error occurred |
InvalidArgumentFault |
The arguments that were passed into services were wrong |
NotLicensedFault |
API is not licensed |
SeatLicenseExpiredFault |
Seat license has expired and needs to be renewed |
SeatLicenseFault |
For service use only |
PauseRecording
Pauses the recording for a given participant (endpoint) in a conference.
This method can use the following parameters:
Request Parameters
Name | Type | Description | Required |
---|---|---|---|
conferenceID |
EntityID |
This is an ID for addressing the room object in the VidyoPortal where the conference is started |
Yes |
recorderID |
String |
A string representing the recording prefix |
Yes |
Response Parameter
Name | Type | Description | Required |
---|---|---|---|
OK |
String |
Acknowledges that the operation was made successfully |
Yes |
Faults
Name | Description |
---|---|
GeneralFault | An unspecified error occurred |
InvalidArgumentFault |
The arguments that were passed into services were wrong |
NotLicensedFault |
API is not licensed |
SeatLicenseExpiredFault |
Seat license has expired and needs to be renewed |
ResumeRecording
Resumes the recording for a given participant (endpoint) in a conference.
This method can use the following parameters:
Request Parameters
Name | Type | Description | Required |
---|---|---|---|
conferenceID |
EntityID |
This is an ID for addressing the room object in the VidyoPortal where the conference is started |
Yes |
recorderID |
String |
A string representing the recording prefix |
Yes |
Response Parameter
Name | Type | Description | Required |
---|---|---|---|
OK |
String |
Acknowledges that the operation was made successfully |
Yes |
Faults
Name | Description |
---|---|
GeneralFault | An unspecified error occurred |
InvalidArgumentFault |
The arguments that were passed into services were wrong |
NotLicensedFault |
API is not licensed |
SeatLicenseExpiredFault |
Seat license has expired and needs to be renewed |
createWebcastURL
Creates a URL for a Webcast.
This method can use the following parameters:
Request Parameter
Name | Type | Description | Required |
---|---|---|---|
roomID |
EntityID |
This is an ID for addressing the room object in the VidyoPortal |
Yes |
Response Parameter
Name | Type | Description | Required |
---|---|---|---|
OK |
String |
Acknowledges that the operation was made successfully |
Yes |
Faults
Name | Description |
---|---|
GeneralFault | An unspecified error occurred |
InvalidArgumentFault |
The arguments that were passed into services were wrong |
NotLicensedFault |
API is not licensed |
SeatLicenseExpiredFault |
Seat license has expired and needs to be renewed |
removeWebcastURL
Removes a URL for a Webcast.
This method can use the following parameters:
Request Parameter
Name | Type | Description | Required |
---|---|---|---|
roomID |
EntityID |
This is an ID for addressing the room object in the VidyoPortal |
Yes |
Response Parameter
Name | Type | Description | Required |
---|---|---|---|
OK |
String |
Acknowledges that the operation was made successfully |
Yes |
Faults
Name | Description |
---|---|
GeneralFault | An unspecified error occurred |
InvalidArgumentFault |
The arguments that were passed into services were wrong |
NotLicensedFault |
API is not licensed |
SeatLicenseExpiredFault |
Seat license has expired and needs to be renewed |
GetWebcastURL
Gets the Webcast URL and PIN indicator for a room.
This method can use the following parameters:
Request Parameters
Name | Type | Description | Required |
---|---|---|---|
roomID |
EntityID |
This is an ID for addressing the room object in the VidyoPortal |
Yes |
Response Parameters
Name | Type | Description | Required |
---|---|---|---|
webCastURL |
String |
Webcast URL |
Yes |
hasWebCastPIN |
Boolean |
If room has a pin |
Yes |
Faults
Name | Description |
---|---|
GeneralFault | An unspecified error occurred |
InvalidArgumentFault |
The arguments that were passed into services were wrong |
NotLicensedFault |
API is not licensed |
SeatLicenseExpiredFault |
Seat license has expired and needs to be renewed |
createWebcastPin
Creates a PIN for a Webcast.
This method can use the following parameters:
Request Parameters
Name | Type | Description | Required |
---|---|---|---|
roomID |
EntityID |
This is an ID for addressing the room object in the VidyoPortal |
Yes |
pin |
String |
Webcast Pin |
Yes |
Response Parameter
Name | Type | Description | Required |
---|---|---|---|
OK |
String |
Acknowledges that the operation was made successfully |
Yes |
Faults
Name | Description |
---|---|
GeneralFault | An unspecified error occurred |
InvalidArgumentFault |
The arguments that were passed into services were wrong |
NotLicensedFault |
API is not licensed |
SeatLicenseExpiredFault |
Seat license has expired and needs to be renewed |
removeWebcastPin
Removes a PIN for a Webcast.
This method can use the following parameters:
Request Parameter
Name | Type | Description | Required |
---|---|---|---|
roomID |
EntityID |
This is an ID for addressing the room object in the VidyoPortal |
Yes |
Response Parameter
Name | Type | Description | Required |
---|---|---|---|
OK |
String |
Acknowledges that the operation was made successfully |
Yes |
Faults
Name | Description |
---|---|
GeneralFault | An unspecified error occurred |
InvalidArgumentFault |
The arguments that were passed into services were wrong |
NotLicensedFault |
API is not licensed |
SeatLicenseExpiredFault |
Seat license has expired and needs to be renewed |
RecordsSearch
Provides records based on different criteria plus access levels. It can be used for output records paging via offset and limit parameters in a conjunction with a previous GetRecordsSearchCountRequest element. The userName is detected based on the user name logged in and the current tenant. tenantName is optional and can be used only by a Super Admin only. The default sorting criteria are by date descending. Output is limited to 200 records. The sortBy valid values are date, (the default) title and room.
This method can use the following parameters:
Request Parameters
Name | Type | Description | Required |
---|---|---|---|
tenantName |
String |
For Super Admin level |
No |
usernameFilter |
String |
For Admin level |
No |
roomFilter |
String |
Filter based on roomName |
No |
sortBy |
sortBy |
The field by which the results should be sorted by. Valid values are “date,” “title,” and “room”. |
Yes |
query |
String |
The search string that uses the above filter criteria. |
No |
recordScope |
recordScopeFilter |
new public private organizational |
Yes |
dir |
sortDirection |
Sort direction: ASC, DESC |
Yes |
limit |
Integer |
Max 200 |
No |
start |
Integer |
Start search record from a specific |
No |
webcast |
Boolean |
Search by webcast |
No |
Response Parameters
Name | Type | Description | Required |
---|---|---|---|
allVideosCount |
Integer |
Total available user records count including public and organizational records from other users |
No |
searchCount |
Integer |
Available user records count after applying search filtering |
No |
myVideosCount |
Integer |
Total user records count for user own records Note: Admin has access for all available user records under particular tenant. |
No |
webcastCount |
Integer |
Total webcasts count for particular user |
No |
newCount |
Integer |
Total private records count for particular user |
No |
privateCount |
Integer |
Total organizational records count for particular user |
No |
organizationalCount |
Integer |
Total public records count for particular user |
No |
publicCount |
Integer |
Records array returned based on limit and offset criteria. Maximum output limit is 200 records |
No |
Faults
Name | Description |
---|---|
GeneralFault | An unspecified error occurred |
AccessViolationFault |
Access Violation Fault |
RecordsById
Provides the recordfile by record IDs.
Note: Only records to which that user has view access are shown.
This method can use the following parameters:
Request Parameter
Name | Type | Description | Required |
---|---|---|---|
id |
Integer |
Record ID |
Yes |
Response Parameter
Name | Type | Description | Required |
---|---|---|---|
OK |
String |
Acknowledges that the operation was made successfully |
Yes |
Fault
Name | Description |
---|---|
GeneralFault | An unspecified error occurred |
updateRecord
Provides updates of records for the following fields:
- Title (if not provided)
- Comments (if not provided)
- Tags (if not provided)
- Record Scope (if not provided)
- PIN (if not provided)
1 – New
2 – Private
3 – Organizational
4 – Public
Empty String - PIN removed from the record based on record id. If the record value is not provided, the same value will be retained.
Only records that the user has view access to are shown.
This method can use the following parameters:
Request Parameters
Name | Type | Description | Required |
---|---|---|---|
id |
Integer |
ID number |
Yes |
title |
String |
Title |
No |
comments |
String |
Comments |
No |
tags |
String |
Tags |
No |
recordScope |
recordScopeUpdate |
Record Scope |
No |
pin |
String |
Pin |
No |
Faults
Name | Description |
---|---|
GeneralFault | An unspecified error occurred |
AccessViolationFault |
Access Violation Fault |
deleteRecord
Deletes a record based on the record ID.
This method can use the following parameters:
Request Parameter
Name | Type | Description | Required |
---|---|---|---|
id |
Integer |
Id |
Yes |
Faults
Name | Description |
---|---|
GeneralFault | An unspecified error occurred |
AccessViolationFault |
Access Violation Fault |
getVidyoReplayLibrary
Provides registered users with the link to the VidyoReplay library which hosts all the recordings on a particular tenant on the VidyoPortal.
This method can use the following parameters:
Response Parameters
Name | Type | Description |
---|---|---|
authToken |
String |
Authentication token that will be used when the user accesses the VidyoReplay library |
vidyoReplayLibraryUrl |
String |
Returns the URL of the VidyoReplay library |
Faults
Name | Description |
---|---|
GeneralFault | An unspecified error occurred |
NotLicensedFault |
API is not licensed |
VidyoReplayNotAvailableFault |
Returned when VidyoReplay is not set up on the specified tenant |
Comments
0 comments
Please sign in to leave a comment.