Cisco Headend System Release 2.5
Remote DVR Access API
Application Guide
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.