|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface LightweightTriggerSession
This interface represents a session created to build an artificial carousel with a DSMCCStreamEvent.
Method Summary | |
---|---|
BufferingRequest |
getBufferingRequest()
Gets the BufferingRequest for the stream type of
interest. |
OcapLocator |
getLocator()
Gets the locator for the artificial carousel. |
NetworkInterface |
getNetworkInterface()
Gets the NetworkInterface for the stream type of
interest. |
int[] |
getPIDs()
Get the array of PIDs for the streams with the stream type of interest. |
RecordingRequest |
getRecordingRequest()
Gets the RecordingRequest for the stream type of interest. |
javax.tv.service.Service |
getService()
Gets the broadcast service for which this session was created. |
javax.tv.service.selection.ServiceContext |
getServiceContext()
Gets the ServiceContext for the stream type of
interest. |
short |
getStreamType()
Gets the stream type this session was created for and that the handler registered interest in. |
boolean |
isAuthorized()
Returns the CA authorization status for the stream(s) referenced by getPIDs() . |
boolean |
isPresenting()
Returns an indication of service containing stream type is presenting to outputs or display, or if it is being buffered or recorded in the background. |
void |
registerEvent(java.util.Date date,
java.lang.String name,
int id,
byte[] data)
Registers a synchronized event to the stream event list for this session. |
void |
setStreamChangeListener(StreamChangeListener listener)
Sets the listener for this session. |
void |
stop()
Stops the session. |
void |
store()
Stores the artificial carousel created for an open session with any permanent recordings made of any elementary streams in the same program as the stream type associated with the open session. |
Method Detail |
---|
OcapLocator getLocator()
ServiceDomain
attach method call as long as the
service containing the stream is presenting or is accessible in a
time-shift buffer.
The return value is constant for the life of this object.
short getStreamType()
The return value is constant for the life of this object.
int[] getPIDs()
The return value MAY change over the life of this object. Changes
are signaled by invocation of StreamChangeListener.notifyPIDsChanged(int[])
on the set
listener.
javax.tv.service.Service getService()
Service
object representing the program
for which this session was created SHALL be returned.
The return value is constant for the life of this object.
Service
object representing the servicejavax.tv.service.selection.ServiceContext getServiceContext()
ServiceContext
for the stream type of
interest.
The return value is constant for the life of this object.
ServiceContext
has selected or is in the process
of selecting the service containing the stream type of interest and the
calling application has permission to access it, then the
ServiceContext
for this session is returned,
otherwise this method returns null.BufferingRequest getBufferingRequest()
BufferingRequest
for the stream type of
interest.
The return value is constant for the life of this object.
BufferingRequest
for the stream is returned,
otherwise this method returns null.NetworkInterface getNetworkInterface()
NetworkInterface
for the stream type of
interest.
The return value is constant for the life of this object.
NetworkInterface
is tuned to the service carrying the
stream type of interest it is returned, otherwise this
method returns null.RecordingRequest getRecordingRequest()
RecordingRequest
for the stream type of interest.
The return value is constant for the life of this object.
RecordingRequest
is returned; otherwise this method returns null.boolean isPresenting()
The return value MAY change over the life of this object. Changes
are signaled by invocation of StreamChangeListener.notifyPresentationChanged(boolean)
on the set
listener.
boolean isAuthorized()
getPIDs()
.
The return value MAY change over the life of this object. Changes
are signaled by invocation of StreamChangeListener.notifySessionStopped(int)
on the set
listener.
void registerEvent(java.util.Date date, java.lang.String name, int id, byte[] data)
date
- The time when the event is to be generated. The
implementation SHALL create JMF media time from this value for
use with presenting broadcast and recorded services.name
- A name for the event being registered. This name SHALL
appear in the list of events returned by the DSMCCStreamEvent
getEventList method.id
- The unique identifier of the event.data
- Application specific data associated with the event.
This data will be delivered with the StreamEvent
when the media time is incurred in the interested stream during
playback. The maximum size of this data is 4096 bytes.
java.lang.IllegalArgumentException
- if the name or id already exist, or
if the data array contains more than 4096 byte entries.
java.lang.IllegalStateException
- if the session is not open, i.e. has
been stopped by the implementation or an application.void setStreamChangeListener(StreamChangeListener listener)
If the session has already been stopped by the implementation when the
listener is set, then the listener SHALL be notified immediately
via StreamChangeListener.notifySessionStopped(int)
.
listener
- The listener to set. If null any previously set
listener is removed.void stop()
void store()
DSMCCStreamEvent
so that they occur at the same point in
the recording presentation as they did in the presentation recorded
from. The implementation SHALL store all events added to the
DSMCCStreamEvent
while the session is active, i.e. events
added after the LightweightTriggerHandler.notifyStreamType(org.ocap.dvr.event.LightweightTriggerSession)
method was called and before the stop
is called for the
session. If a session does not contain any registered events that
fall within the duration of a recording when the session is stopped
the artificial carousel is not stored with the recording. The
implementation SHALL update the stored carousel as soon as an
event is registered that falls within the duration of the recording.
It is illegal to call this method after a session has been closed.
java.lang.SecurityException
- if the calling application does not have
file permission granted in its permission request file.
java.lang.IllegalStateException
- if this method is called after the
session has been closed, or if there are no events in the
artificial carousel.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |