Bureaucrats, editor
48
edits
Changes
Jump to navigation
Jump to search
no edit summary
{{Api_Method_Spec|
Description= Gets info on a specific recording schedule (returned as a [[RecordingSchedule|RecordingSchedule]] object). The Id of the recording schedule to be retrieved is provided as an input parameter.
<p>* '''MiViewTV comments''':</p>
* Because of the "reutilisation" of programIds in "virtual channels", a programId could be repeated in different channels. This way, although ALU considers the concept of "recording (schedule) id" (with value equal to the programId), a programId is actually not enough to identify a precise recording, as it is also necessary to provide the channelId. This way, the real value that allows a unique identification of recording schedules in ALU is the combination of programId (or recording_id in the ALU model) + channelId (service_uid in the ALU terminology). This way, the id of the recording schedule returned to clients by UNIAPI (member "ID" of the object [[RecordingSchedule|RecordingSchedule]]), in the case of MiView, will be a string concatenating the id (programId) with the service_uid (channel). eg: "4800508_3" (where 4800508 would be the recording id/programId returned by MiView and "3" would be the corresponding service_uid)
<p>* '''Mirada comments''':</p>
* In the case of series/recurring recording schedules, a usual case is that the client requests info on the "parent"/container RecordingSchedule (in order to later cancel/delete the whole series definition, etc.). Please, notice that this [[RecordingSchedule|RecordingSchedule]] will be (in this case for series) just a "container" or parent definition, with no precise event (program, channel, time) info associated.
* In Mirada, when creating a "series recording schedule", UNIAPI only creates the "containter"/parent recording, and the STB will add all the associated episodes automatically (as a recording "Linked" to a parent recording). In the case of series, Mirada method will return the "parent"/container recording that will not have associated "events" and all the recordings for the precise "events" associated to that "parent". "Child" recordings will have a reference to their parent (series recording schedule)
|Parameters=
}}
{{Api_Parameter|
ParamName=targetDeviceIdrecordingScheduleId|ParamType=intstring|ParamRequired=optionalrequired|ParamDescription=Allows identifying the user's device ID (STBstring) on which of the application will be applied, in the case that several DVR devices may exist in the household (does not apply Recording Schedule to MiView and Mediaroom)retrieve info
}}
{{Api_Parameter|
|Returns=
Returns a [[RecordingScheduleExtendedRecordingSchedule|RecordingScheduleExtendedRecordingSchedule]] object.
'''Example:'''
{
: [[RecordingScheduleExtendedRecordingSchedule|RecordingScheduleExtendedRecordingSchedule]] object
}
|Exceptions=
Possible error results (included in the GVP general error list) are:* None.8 MissingRequiredParameter ''OpenPlatf, Mirada''*211 RecordingSubscriberNotFound ''OpenPlatf, MiViewTv, Mirada, Mediaroom''*212 RecordingSubscriberNotSubscribed ''OpenPlatf, Mirada''*213 RecordingUnknownError ''OpenPlatf, MiViewTv, Mirada, Mediaroom''*223 RecordingProgramNotFound ''OpenPlatf, MiViewTv, Mirada''*235 RequestedLanguagesUnavailable ''OpenPlatf, Mirada''*236 RecordingUpdatedFromAnotherDevice ''OpenPlatf, Mirada''*239 RecordingNotFound ''OpenPlatf, MiViewTv''*245 RecordingUnknownRecordingType ''OpenPlatf, Mediaroom''*246 RecordingUnknownPagingType ''OpenPlatf, Mediaroom''
|Cache=
! Changes author
{{!}}- valign="top"
! 2.4drop 1{{!}} Initial method design(for MiView, Mirada and Mediaroom)
{{!}}
{{!}}- valign="top"
! 2.4 drop 1
{{!}} Add Support for OpenPlatf in cPVR. Extends with Casting
{{!}} José Manuel Escartín
{{!}}}
* [[RecordingScheduleState|RecordingScheduleState]] enum
* [[RecordingSchedule|RecordingSchedule]] object type
* [[GetAllRecordingScheduleGetAllRecordingSchedules|GetAllRecordingScheduleGetAllRecordingSchedules]] method
* [[UNIAPI_Specification#Network_Pvr_Service|Network_Pvr_Service]] methods
}}
