|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
This interface represents a particular event within a service.
Each object that implements the SIEvent interface is defined by the combination of the identifiers original_network_id, transport_stream_id, service_id, event_id.
Where methods return values from a short_event_descriptor, the following
algorithm shall be used where more than one such descriptor is present.
If the language returned by javax.tv.service.SIManager.getPreferredLanguage
is one of those for which there is a short_event_descriptor then return the value from
that descriptor. Otherwise return an implementation dependent selection between the
values in the available short_event_descriptors.
SIService
Field Summary |
Fields inherited from interface org.dvb.si.SIInformation |
FROM_CACHE_ONLY, FROM_CACHE_OR_STREAM, FROM_STREAM_ONLY |
Method Summary | |
byte[] |
getContentNibbles()
This method returns the content nibbles related to the event. |
long |
getDuration()
Get the duration of this event. |
DvbLocator |
getDvbLocator()
Gets a DvbLocator that identifies this event. |
int |
getEventID()
Get the event identification. |
boolean |
getFreeCAMode()
Get the free_CA_mode value for this event, false indicates none of the component streams of this event are scrambled. |
byte[] |
getLevel1ContentNibbles()
This method returns the level 1 content nibbles of this event. |
java.lang.String |
getName()
This method returns the name of this event. |
int |
getOriginalNetworkID()
Get the original network identification identifier. |
byte |
getRunningStatus()
Get the running status of this event. |
int |
getServiceID()
Get the service identification identifier. |
java.lang.String |
getShortDescription()
This method returns the description of this event. |
java.lang.String |
getShortEventName()
This method returns the short event name (ETR 211) of this event without emphasis marks. |
java.util.Date |
getStartTime()
Get the start time of this event in UTC time. |
int |
getTransportStreamID()
Get the transport stream identification identifier. |
SIRequest |
retrieveSIService(short retrieveMode,
java.lang.Object appData,
SIRetrievalListener listener,
short[] someDescriptorTags)
This method retrieves the SIService object representing the service the event, represented by this SIEvent, is part of. |
Methods inherited from interface org.dvb.si.SIInformation |
fromActual, getDataSource, getDescriptorTags, getSIDatabase, getUpdateTime, retrieveDescriptors, retrieveDescriptors |
Method Detail |
public DvbLocator getDvbLocator()
public int getOriginalNetworkID()
public int getTransportStreamID()
public int getServiceID()
public int getEventID()
public java.util.Date getStartTime()
public long getDuration()
public byte getRunningStatus()
SIRunningStatus
public boolean getFreeCAMode()
public java.lang.String getName()
public java.lang.String getShortEventName()
public java.lang.String getShortDescription()
public byte[] getLevel1ContentNibbles()
public byte[] getContentNibbles()
public SIRequest retrieveSIService(short retrieveMode, java.lang.Object appData, SIRetrievalListener listener, short[] someDescriptorTags) throws SIIllegalArgumentException
The SIIterator that is returned with the event when the request completes successfully will contain an object that implements the SIService interface. If no matching object was found, the appropriate one of the following events is sent: SINotInCacheEvent SIObjectNotInTableEvent or SITableNotFoundEvent.
retrieveMode
- Mode of retrieval indicating whether the data should
be retrieved only from the cache (FROM_CACHE_ONLY),
from the cache if available and if not from the stream
(FROM_CACHE_OR_STREAM), or always from the stream
(FROM_STREAM_ONLY).appData
- An object supplied by the application. This object will
be delivered to the listener when the request completes.
The application can use this objects for internal
communication purposes. If the application does not
need any application data, the parameter can be null.listener
- SIRetrievalListener that will receive the event informing
about the completion of the request.someDescriptorTags
- A list of hints for descriptors (identified by their tags)
the application is interested in. If the array contains -1
as its one and only element, the application is interested
in all descriptors. If someDescriptorTags is null, the
application is not interested in descriptors.
All values
that are out of the valid range for descriptor tags (i.e.
0...255) are ignored, except for the special meaning of -1 as
the only element in the array.
SIIllegalArgumentException
- thrown if the retrieveMode is invalidSIRequest
,
SIRetrievalListener
,
SIService
,
DescriptorTag
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |