|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.dvb.dsmcc.DSMCCStream
org.dvb.dsmcc.DSMCCStreamEvent
public class DSMCCStreamEvent
The DSMCCStreamEvent class is used to manage DSMCC StreamEvent Objects.
Applications wishing to monitor changes in the list of events which are
part of this stream event should use DSMCCObject.addObjectChangeEventListener
on the DSMCCObject
representing which describes this set of stream events.
The BIOP::StreamEvent message shall be read from the network once only, before the constructor
of this class returns. Hence methods which return information from that message shall not
be affected by any subsequent changes to that information.
The subscribe method only verifies that the event name can be bound to an eventId but it does not require that the stream event descriptors for that event id can be received at that moment. While the event listener is registered the GEM terminal shall filter the stream event descriptors as specified in the "Monitoring broadcast timebases and events" clause in the main body of the specification.
NOTE: The NPT mechanism and scheduled stream events that depend on it are known to be vulnerable to disruption in many digital TV distribution networks. Existing deployed network equipment that re-generates the STC is unlikely to be aware of NPT and hence will not make the necessary corresponding modification to STC values inside NPT reference descriptors. Applications should only use NPT where they are confident that the network where they are to be used does not have this problem.
NOTE [GEM P.2.3]: References to the BIOP::StreamEvent message are to be interpreted as meaning the stream even description defined in clause B.4.1. References to elements of the BIOP messages are to be interpreted as referring to the corresponding element of the generic descriptions from annex B, as detailed below. Throughout this class, references to a DSMCC StreamEvent in the signalling are to be read as referring to a trigger object, as defined in clause B.4.1.
Constructor Summary | |
---|---|
DSMCCStreamEvent(DSMCCObject aDSMCCObject)
Create a DSMCCStreamEvent from a DSMCCObject . |
|
DSMCCStreamEvent(java.lang.String path)
Create a DSMCCStreamEvent Object from its pathname. |
|
DSMCCStreamEvent(java.lang.String path,
java.lang.String name)
Create a DSMCCStreamEvent from its pathname. |
Method Summary | |
---|---|
java.lang.String[] |
getEventList()
This function is used to get the list of the events of the DSMCCStreamEvent object. |
int |
subscribe(java.lang.String eventName,
StreamEventListener l)
This function is used to subscribe to an event of a DSMCC StreamEvent object. |
void |
unsubscribe(int eventId,
StreamEventListener l)
This function is used to cancel the subscription to an event of a DSMCCEvent object. |
void |
unsubscribe(java.lang.String eventName,
StreamEventListener l)
This function is used to cancel the subscription to an event of a DSMCCEvent object. |
Methods inherited from class org.dvb.dsmcc.DSMCCStream |
---|
addNPTListener, getDuration, getMediaTimeFromStream, getNPT, getNPTRate, getStreamLocator, isAudio, isData, isMPEGProgram, isVideo, removeNPTListener |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public DSMCCStreamEvent(DSMCCObject aDSMCCObject) throws NotLoadedException, IllegalObjectTypeException
DSMCCStreamEvent
from a DSMCCObject
.
The Object has to be a DSMCC StreamEvent.
aDSMCCObject
- the DSMCC object which describes the stream.
NotLoadedException
- the DSMCCObject is not loaded.
IllegalObjectTypeException
- the DSMCCObject does not lead to a DSMCC StreamEvent.public DSMCCStreamEvent(java.lang.String path) throws java.io.IOException, IllegalObjectTypeException
path
- the pathname of the DSMCCStreamEvent object
java.io.IOException
- An IO error has occurred.
IllegalObjectTypeException
- the path does not lead to a DSMCC StreamEvent.public DSMCCStreamEvent(java.lang.String path, java.lang.String name) throws java.io.IOException, IllegalObjectTypeException
path
- the directory path.name
- the name of the DSMCCStreamEvent Object.
java.io.IOException
- If an IO error occurred.
IllegalObjectTypeException
- the path does not lead to a DSMCC StreamEvent.Method Detail |
---|
public int subscribe(java.lang.String eventName, StreamEventListener l) throws UnknownEventException, InsufficientResourcesException
eventName
- the name of the event.l
- an object that implements the StreamEventListener Interface.
UnknownEventException
- the event cannot be found at this time
InsufficientResourcesException
- if resources needed to perform
the subscription are not availablepublic void unsubscribe(int eventId, StreamEventListener l) throws UnknownEventException
eventId
- Identifier of the event.l
- an object that implements the StreamEventListener Interface.
UnknownEventException
- The event can not be found.public void unsubscribe(java.lang.String eventName, StreamEventListener l) throws UnknownEventException
eventName
- the name of the event.l
- an object that implements the StreamEventListener Interface.
UnknownEventException
- The event can not be found.
NOTE [GEM P.2.3.1.3]: For the lightweight binding of the trigger API,
this method may always throw this exception.public java.lang.String[] getEventList()
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |