GetRecordingSchedule - Revision history

Rmc352 at 14:27, 3 July 2019

2019-07-03T14:27:16Z

Id02660 at 10:32, 5 April 2019

2019-04-05T10:32:05Z

Id02660 at 10:31, 5 April 2019

2019-04-05T10:31:18Z

Id01213 at 10:16, 5 November 2014

2014-11-05T10:16:01Z

Id01213 at 09:34, 5 November 2014

2014-11-05T09:34:40Z

Id01213 at 11:26, 31 October 2014

2014-10-31T11:26:48Z

Id01213 at 09:28, 31 October 2014

2014-10-31T09:28:44Z

Id01213 at 09:24, 31 October 2014

2014-10-31T09:24:56Z

Id01213 at 08:40, 31 October 2014

2014-10-31T08:40:40Z

Id01213 at 08:32, 31 October 2014

2014-10-31T08:32:10Z

@@ Line 71: / Line 71: @@
 {{!}}- valign="top"
 ! 2.4 drop 1
-{{!}} Add Support for OpenPlatf. Extends with Casting
+{{!}} Add Support for OpenPlatf in cPVR. Extends with Casting
 {{!}} José Manuel Escartín
 {{!}}}

@@ Line 31: / Line 31: @@
 |Returns=
-Returns a [[RecordingSchedule|RecordingSchedule]] object.
+Returns a [[ExtendedRecordingSchedule|ExtendedRecordingSchedule]] object.
 '''Example:'''
+{
-:   [[RecordingSchedule|RecordingSchedule]] object
+:   [[ExtendedRecordingSchedule|ExtendedRecordingSchedule]] object
+}

@@ Line 42: / Line 42: @@
 |Exceptions=
 Possible error results (included in the GVP general error list) are:
-* 8	MissingRequiredParameter		''Mirada''
+* 8	MissingRequiredParameter		''OpenPlatf, Mirada''
-*211	RecordingSubscriberNotFound		''MiViewTv, Mirada, Mediaroom''
+*211	RecordingSubscriberNotFound		''OpenPlatf, MiViewTv, Mirada, Mediaroom''
-*212	RecordingSubscriberNotSubscribed	''Mirada''
+*212	RecordingSubscriberNotSubscribed	''OpenPlatf, Mirada''
-*213	RecordingUnknownError			''MiViewTv, Mirada, Mediaroom''
+*213	RecordingUnknownError			''OpenPlatf, MiViewTv, Mirada, Mediaroom''
-*223	RecordingProgramNotFound		''MiViewTv, Mirada''
+*223	RecordingProgramNotFound		''OpenPlatf, MiViewTv, Mirada''
-*235	RequestedLanguagesUnavailable		''Mirada''
+*235	RequestedLanguagesUnavailable		''OpenPlatf, Mirada''
-*236	RecordingUpdatedFromAnotherDevice	''Mirada''
+*236	RecordingUpdatedFromAnotherDevice	''OpenPlatf, Mirada''
-*239	RecordingNotFound			''MiViewTv''
+*239	RecordingNotFound			''OpenPlatf, MiViewTv''
-*245	RecordingUnknownRecordingType	''Mediaroom''
+*245	RecordingUnknownRecordingType	''OpenPlatf, Mediaroom''
-*246	RecordingUnknownPagingType	''Mediaroom''
+*246	RecordingUnknownPagingType	''OpenPlatf, Mediaroom''
 |Cache=
@@ Line 69: / Line 69: @@
 {{!}} Initial method design (for MiView, Mirada and Mediaroom)
 {{!}}
 {{!}}}

@@ Line 46: / Line 46: @@
 *212	RecordingSubscriberNotSubscribed	''Mirada''
 *213	RecordingUnknownError			''MiViewTv, Mirada, Mediaroom''
-*223	RecordingProgramNotFound		''MiViewTv''
+*223	RecordingProgramNotFound		''MiViewTv, Mirada''
 *235	RequestedLanguagesUnavailable		''Mirada''
 *236	RecordingUpdatedFromAnotherDevice	''Mirada''

@@ Line 43: / Line 43: @@
 Possible error results (included in the GVP general error list) are:
 * 8	MissingRequiredParameter		''Mirada''
-*211	RecordingSubscriberNotFound		''MiViewTv, Mirada''
+*211	RecordingSubscriberNotFound		''MiViewTv, Mirada, Mediaroom''
 *212	RecordingSubscriberNotSubscribed	''Mirada''
-*213	RecordingUnknownError			''MiViewTv, Mirada''
+*213	RecordingUnknownError			''MiViewTv, Mirada, Mediaroom''
 *223	RecordingProgramNotFound		''MiViewTv''
 *235	RequestedLanguagesUnavailable		''Mirada''
 *236	RecordingUpdatedFromAnotherDevice	''Mirada''
 *239	RecordingNotFound			''MiViewTv''
 |Cache=

@@ Line 6: / Line 6: @@
 <p>* '''Mirada comments''':</p>
-* Clients wanting to cancel (or delete) a recording should have to firstly request a [[GetAllRecordingSchedules|GetAllRecordingSchedules]] call, in order to retrieve the recordings ID and (in the case of Mirada) the associated lastModified value that must be included in the cancel/delete request. This parameter will not be available (GetAllRecordingSchedules will return 0) for some other rPVR backends.
+* 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.
-* When cancelling things "in the future" (not started yet), such as individual movies/episodes not started yet, or the cancellation of entire series, the final purpose is to "avoid" the future recording of an event. The [[RecordingSchedule|RecordingSchedule]] object would be set to GVP status "Cancelled"
+* 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)
-* When cancelling only a thing that is just being recorded at the current moment (at the moment of invoking cancel by the client) the final purpose is to "stop" the ongoing recording (and the status of the schedule, in both Mirada's backend and in the [[RecordingSchedule|RecordingSchedule]] object returned to clients, would be set to "finished"/completed, not "cancelled"). This is the case when cancelling individual events or episodes within series (but NOT cancelling the whole series) AND the event to cancel is just being recorded at this moment.
 |Parameters=

@@ Line 1: / Line 1: @@
 {{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.
 |Parameters=

@@ Line 56: / Line 56: @@
 * [[RecordingScheduleState|RecordingScheduleState]] enum
 * [[RecordingSchedule|RecordingSchedule]] object type
-* [[GetAllRecordingSchedule|GetAllRecordingSchedule]] method
+* [[GetAllRecordingSchedules|GetAllRecordingSchedules]] method
 * [[UNIAPI_Specification#Network_Pvr_Service|Network_Pvr_Service]] methods
 }}