Represents an archive of an Vonage Video API session. More...
| Public Member Functions | |
| void | Stop () |
| Stops the OpenTok archive if it is being recorded. More... | |
| async Task | StopAsync () |
| Stops the OpenTok archive if it is being recorded. More... | |
| void | Delete () |
| Deletes the OpenTok archive. More... | |
| Task | DeleteAsync () |
| Deletes the OpenTok archive. More... |
| Properties | |
| long | CreatedAt [get, set] |
| The time at which the archive was created, in milliseconds since the Unix epoch. More... | |
| long | Duration [get, set] |
| The duration of the archive, in seconds. More... | |
| Guid | Id [get, set] |
| The archive ID. More... | |
| string | Name [get, set] |
| The name of the archive. More... | |
| int | PartnerId [get, set] |
| The Vonage Video API key associated with the archive. More... | |
| String | SessionId [get, set] |
| The session ID of the Vonage Video API session associated with this archive. More... | |
| String | Reason [get, set] |
| For archives with the status ArchiveStatus.STOPPED or ArchiveStatus.FAILED, this string describes the reason the archive stopped (such as "maximum duration exceeded") or failed. More... | |
| bool | HasVideo [get, set] |
| Whether the archive includes a video track (true) or not (false). More... | |
| bool | HasAudio [get, set] |
| Whether the archive includes an audio track (true) or not (false). More... | |
| string | Resolution [get, set] |
| The resolution of the archive. More... | |
| OutputMode | OutputMode [get, set] |
| Whether all streams in the archive are recorded to a single file (OutputMode.COMPOSED) or to individual files (OutputMode.INDIVIDUAL). To record streams to individual files, pass OutputMode.INDIVIDUAL as the OutputMode parameter when calling the OpenTok.StartArchive method. More... | |
| long | Size [get, set] |
| The size of the MP4 file. For archives that have not been generated, this value is set to 0. We use long instead of int to support archives larger than 2GB. More... | |
| ArchiveStatus | Status [get, set] |
| The status of the archive, as defined by the ArchiveStatus enum. More... | |
| String | Url [get, set] |
| The download URL of the available MP4 file. This is only set for an archive with the status set to ArchiveStatus.AVAILABLE; for other archives, (including archives with the status of ArchiveStatus.UPLOADED) this method returns null. The download URL is obfuscated, and the file is only available from the URL for 10 minutes. To generate a new URL, call the ListArchives() or GetArchive() method of the OpenTok object. More... | |
| String | Password [get, set] |
| The encryption password of the archive. More... | |
| StreamMode | StreamMode [get, set] |
| Whether streams included in the archive are selected automatically ("auto", the default) or manually. More... | |
| string | MultiArchiveTag [get, set] |
| The unique tag for simultaneous archives (if one was set). More... |
Detailed Description
Represents an archive of an Vonage Video API session.
Constructor & Destructor Documentation
Archive()
Initializes a new instance of the Archive class.
Member Function Documentation
Delete()
| void OpenTokSDK.Archive.Delete | ( | ) |
Deletes the OpenTok archive.
You can only delete an archive which has a status of "available" or "uploaded". Deleting an archive removes its record from the list of archives. For an "available" archive, it also removes the archive file, making it unavailable for download.
DeleteAsync()
| Task OpenTokSDK.Archive.DeleteAsync | ( | ) |
Deletes the OpenTok archive.
You can only delete an archive which has a status of "available" or "uploaded". Deleting an archive removes its record from the list of archives. For an "available" archive, it also removes the archive file, making it unavailable for download.
Stop()
| void OpenTokSDK.Archive.Stop | ( | ) |
Stops the OpenTok archive if it is being recorded.
Archives automatically stop recording after 120 minutes or when all clients have disconnected from the session being archived.
StopAsync()
| async Task OpenTokSDK.Archive.StopAsync | ( | ) |
Stops the OpenTok archive if it is being recorded.
Archives automatically stop recording after 120 minutes or when all clients have disconnected from the session being archived.
Property Documentation
CreatedAt
The time at which the archive was created, in milliseconds since the Unix epoch.
Duration
The duration of the archive, in seconds.
HasAudio
Whether the archive includes an audio track (true) or not (false).
HasVideo
Whether the archive includes a video track (true) or not (false).
Id
The archive ID.
MultiArchiveTag
The unique tag for simultaneous archives (if one was set).
Name
The name of the archive.
OutputMode
Whether all streams in the archive are recorded to a single file (OutputMode.COMPOSED) or to individual files (OutputMode.INDIVIDUAL). To record streams to individual files, pass OutputMode.INDIVIDUAL as the OutputMode parameter when calling the OpenTok.StartArchive method.
PartnerId
The Vonage Video API key associated with the archive.
Password
The encryption password of the archive.
Reason
For archives with the status ArchiveStatus.STOPPED or ArchiveStatus.FAILED, this string describes the reason the archive stopped (such as "maximum duration exceeded") or failed.
Resolution
The resolution of the archive.
SessionId
The session ID of the Vonage Video API session associated with this archive.
Size
The size of the MP4 file. For archives that have not been generated, this value is set to 0. We use long instead of int to support archives larger than 2GB.
Status
The status of the archive, as defined by the ArchiveStatus enum.
StreamMode
Whether streams included in the archive are selected automatically ("auto", the default) or manually.
Url
The download URL of the available MP4 file. This is only set for an archive with the status set to ArchiveStatus.AVAILABLE; for other archives, (including archives with the status of ArchiveStatus.UPLOADED) this method returns null. The download URL is obfuscated, and the file is only available from the URL for 10 minutes. To generate a new URL, call the ListArchives() or GetArchive() method of the OpenTok object.