|
JSR-927 (Maintenance Release) | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
ProgramEvent
represents collection of elementary
streams with a common time base, an associated start time, and an
associated end time. An event is equivalent to the common industry
usage of "TV program."
The Event Information Table (EIT) contains information (titles, start times, etc.) for events on defined services. An event is, in most cases, a typical TV program, however its definition may be extended to include particular data broadcasting sessions and other information segments.
A ProgramEvent
object may optionally implement the
CAIdentification
interface. Note that all time values
are in UTC time.
java.util.Date
,
CAIdentification
,
Optionally implemented interfacesMethod Summary | |
long |
getDuration()
Returns the duration of this program event in seconds. |
java.util.Date |
getEndTime()
Returns the end time of this program event. |
java.lang.String |
getName()
Returns the program event title. |
ContentRatingAdvisory |
getRating()
Reports content advisory information associated with this program for the local rating region. |
Service |
getService()
Reports the Service this program event is associated with. |
java.util.Date |
getStartTime()
Returns the start time of this program event. |
SIRequest |
retrieveComponents(SIRequestor requestor)
Retrieves an array of service components which are part of this ProgramEvent . |
SIRequest |
retrieveDescription(SIRequestor requestor)
Retrieves a textual description of the event. |
Methods inherited from interface javax.tv.service.SIElement |
equals, getLocator, getServiceInformationType, hashCode |
Methods inherited from interface javax.tv.service.SIRetrievable |
getUpdateTime |
Method Detail |
public java.util.Date getStartTime()
public java.util.Date getEndTime()
public long getDuration()
public java.lang.String getName()
public SIRequest retrieveDescription(SIRequestor requestor)
requestor
- The SIRequestor
to be notified
when this retrieval operation completes.
SIRequest
object identifying this
asynchronous retrieval request.ProgramEventDescription
public ContentRatingAdvisory getRating()
ContentRatingAdvisory
object describing the
rating of this ProgramEvent
or null
if
no rating information is available.public Service getService()
Service
this program event is associated with.
Service
this program event is delivered on.public SIRequest retrieveComponents(SIRequestor requestor)
ProgramEvent
. Service component information may not
always be available. If the ProgramEvent
is current,
this method will provide only service components associated with
the Service
to which the ProgramEvent
belongs. If the ProgramEvent
is not current, no
guarantee is provided that all or even any of its service
components will be available.
This method delivers its results asynchronously. The retrieved
array will only contain ServiceComponent
instances
c
for which the caller has
javax.tv.service.ReadPermission(c.getLocator())
. If
no ServiceComponent
instances meet this criteria,
this method will result in an SIRequestFailureType
of
DATA_UNAVAILABLE
.
requestor
- The SIRequestor
to be notified
when this retrieval operation completes.
SIRequest
object identifying this
asynchronous retrieval request.ServiceComponent
,
ReadPermission
|
JSR-927 (Maintenance Release) | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |