Cisco Headend System Release 2.7

Page of 26
 
 
 
Remote DVR Access API 
Application Guide 
Overview 
Introduction 
The Remote DVR Access APIs allow applications to access data managed by the 
SARA DVR recording system. The Remote DVR Access feature provides the 
following capabilities: 
 
Ability to retrieve the present recordings on the DVR. 
 
Ability to delete recordings on the DVR. 
 
Ability to retrieve the presently scheduled recordings. 
 
Ability to cancel scheduled recordings. 
 
Schedule future recordings including all-episode requests. 
 
Determine conflicts so that the user may be presented with the option of 
which recordings to cancel to resolve the request at the time of the scheduling 
or at a later time. 
 
Ability to retrieve the hard disk drive usage percentage. 
 
Ability to initiate playback of recordings. 
To help ensure the consistency of the recording data, the following restrictions are 
enforced: 
 
Requests to modify the scheduled recording list are rejected while conflict 
resolution is in progress.  Presently, the conflict resolution will timeout (if the 
user does not correct the conflict) after three minutes and remove the most 
recent request. 
 
If the local user (at the DVR) is editing data for a program and the remote user 
deletes the program, the local UI will exit the edit screen and return to the 
appropriate DVR list (either Scheduled List or Recorded List). 
 
The application will not be allowed to schedule a recording within three 
minutes of the program start time so that conflicts can be handled before the 
recording begins.