|
||||||||||
PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES |
See:
Description
Interface Summary | |
CAListener | This interface is implemented by an object in the application that can be registered to receive events related to CA |
DescramblerListener | This interface is implemented by an object in the application that can be registered to receive events related to an on-going descrambling activity |
MessageListener | Objects of the application that want to be registered to receive events related to message passing with CA modules must implement this interface. |
MMIListener | The object in the application that wants to register to receive events related to the MMI dialogues must implement this interface. |
Class Summary | |
CAEvent | Base class for CA events |
CAMessage | This class represents messages to CA modules. |
CAModule | CAModule class represents a physical CA Module |
CAModuleManager | The CA module manager is an object that manages available CA modules. |
CloseMMIEvent | This event informs application(s) that an MMI dialogue has to be closed. |
DescramblerEvent | Base class for events related to an on-going descrambling activity |
DescramblerProxy | The class DescramblerProxy is a proxy for the descrambling resources. |
DescramblingStartedEvent | This event sent to the resource status event listeners when the descrambling of a service is started. |
DescramblingStoppedEvent | This event sent to the resource status event listeners when the descrambling is stopped because of the application itself stopping it or because the descrambling resources were revoked by some other part of the system. |
Enquiry | Class representing an enquiry MMI object. |
List | Class representing a List MMI object. |
Menu | Class representing a Menu MMI. |
MessageEvent | Base class of events related to message passing in the CA API |
MMIActiveEvent | This event informs that an MMI user dialog has been started |
MMIEvent | Base class for events related to MMI dialogs |
MMIInactiveEvent | This event informs that an MMI user dialog has ended |
MMIObject | The base class of all MMI classes. |
ModuleRemovedEvent | This event informs that a CA module has been removed. |
ModuleResponseEvent | Base class for events that carry a message from the module |
ModuleStateChangedEvent | This event is sent for a specific session, at the moment that the state of the module (as far as relevant to that session) has changed. |
NewModuleEvent | This event informs that a new CA module has been added. |
PIDChangeEvent | In systems based upon the DVB Common Interface this event is generated in response to the Host Control replace /clear_replace requests. |
SessionClosedEvent | Event to notify the application that a session has been closed. |
SessionOpenedEvent | Event to notify the application that a session has been opened. |
StartMMIEvent | This event informs an application that an MMI dialogue has to be started. |
Text | Class representing a text MMI object. |
TuneRequestEvent | In systems based upon the DVB Common Interface this event is generated in response to the Host Control tune request. |
Exception Summary | |
BufferFullException | This exception is raised when sendToModule() is called when the message buffer is full. |
CAException | Base class for exceptions in the CA API |
InvalidSetException | This exception is raised if an application tries to set an invalid response value in the MMI object methods or calls the methods to set the response more than once. |
MMIListenerAlreadyRegisteredException | This exception is raised if an application tries to register a listener for the MMI events and there is already a listener registered. |
ModuleBusyException | This exception is raised when a method is called and the module is busy and can not perform the requested action. |
ModuleResourceNonExistentException | This exception is raised when the resource requested by the application in the message passing functions does not exist in the module. |
ModuleResourceVersionTooLowException | This exception is raised when the version of the resource requested by the application in the message passing functions is lower than what the application requested. |
ModuleUnavailableException | This exception is raised when a method is called and the module is no longer available |
NoCapacityException | This exception is raised when there isn't sufficient descrambling capacity available. |
NoFreeCapacityException | This exception is thrown when a method is called and the CA module does not have the required capacity to perform the action |
NotTunedException | This exception is raised when the called method can not perform the action because the receiver is not tuned to the transport stream that carries the necessary information required to perform the action. |
UnknownSessionException | This exception is raised when the application tries to close or send a message to an unknown session. |
Provides an interface to various features of a conditional access system for those applications which need it.
The following changes made in the DVB specification have been implemented.
The following errata agreed in DVB have been implemented with respect to the original DAVIC work.
This method is considered to have the following text appended to its description:
"If an application has registered (and not removed) a listener to handle the MMI dialogues and if an MMI dialogue is required, this causes the platform to ask the MMI listener to handle the MMI dialogues. If there is no application registered to handle the MMI dialogues, these will be handled by the platform."
This method is considered to have the following text appended to its description : "If an empty array is passed in, returns true."
This method is considered to have the following text appended to its description : "If the service passed as a parameter is not scrambled,returns an empty array whose length is 0."
This method is considered to have the following description for the CAModule parameter : the CAModule object that is the source of the event, which shall be returned by the getSource()method.
This method is considered to have the following text appended to its description : "If org.davic.mpeg.ElementaryStream[]is a zero length array the method has no effect."
This method is considered to have the following text appended to its description : "DescramblerProxy applies from the point of view of one application. Methods such as startDescrambling() and stopDescrambling apply on a per-application basis and do not impact descrambling on behalf of other applications, except subject to platform resource limitations.
This method is considered to have the following text appended to its description : "If org.davic.mpeg.ElementaryStream[]is a zero length array the method has no effect."
This method is considered to have the following text appended to its description : "If org.davic.mpeg.ElementaryStream[]is a zero length array the method has no effect."
This method is considered to have the following text appended to its description : "If no descrambling is being done then this method has no effect"
The description of the "streams" parameter shall be as follows : " streams : array of ElementaryStreams whose descrambling is to be stopped."
This method is considered to have the following text appended to its description : "The stopDescrambling method only effects members of the array of streams that are being descrambled. There is no effect on any streams listed in the array that are not being descrambled."
This method is considered to have the following text appended to its description : "The method stopDescrambling( ElementaryStream[])only stops the descrambling of streams which have been started through this DescramblerProxy instance,and not started through any other instance."
The throws clause for ModuleBusyException is considered to have the following added on the end of it - "This is CA system dependant."
This method is considered to include the following clause:
Throws: org.davic.net.InvalidLocatorException if the locator does not point to a valid service or event.
Now includes a detailed specification for mapping onto the common interface. This is too detailed to list here.
Now includes a detailed specification for mapping onto the common interface. This is too detailed to list here.
The description of this method is considered to have the following text added to it.
In systems based on the DVB common interface, messages sent using this method shall be mapped onto the CAPipelineRequest as defined in section 6.8.3 of the common interface extensions specification. Responses from the CA system reported through the CAPipelineResponse and CAPipelineNotification messages shall be mapped onto instances of ModuleResponseEvent.
In the comments of all signature versions of this method, the sentence:
This method may start an MMI dialog.
is replaced with
This method may result in the CA system requesting an MMI dialog.
The description of this method is considered to have the following text added to it.
In systems based on the DVB common interface, messages sessions opened using this method shall be mapped onto the CA pipeline for the module represented by this CAModule instance as defined in section 6.8. of the common interface extensions specification. Neither the module_id or the resource_id of the module are visible to the application. It is the responsibility of the platform to perform the relevant mapping. NOTE:The document referred to as "common interface extensions specification." is TS 101 699 [71 ].
The following text:
Throws: ModuleResourceNonExistentException raised if the specified resource cannot be addressed. This includes situations where the resource is not present in the module as well as addressing what would be a public resource in a DAVIC CA0 /DVB-CI system.
Is considered to be replaced by:
Throws: ModuleResourceNonExistentException raised if the specified resource is not present in the module.
NOTE: The ModuleResourceVersionTooLowException shall never be thrown in this version of this specification.
This class is considered to have a no argument protected constructor with the following statement attached to it:
This constructor is provided for the use of implementations and specifications which extend this specification. Applications shall not define sub-classes of this class. Implementations are not required to behave correctly if any such application defined sub-classes are used.
The description of all these methods is considered to be extended by the following text:
In systems based on the DVB common interface this maps onto ca_pmt with ca_pmt_cmd_id = ok_descrambling (Common Interface specification,section 8.4.3.4) and the NotAuthorizedException shall never be thrown.
In systems based on the DVB common interface,the NotAuthorizedException shall never be thrown.
This class is considered to have a no argument protected constructor with the following statement attached to it:
This constructor is provided for the use of implementations and specifications which extend this specification. Applications shall not define sub-classes of this class. Implementations are not required to behave correctly if any such application defined sub-classes are used.
The class description for this class is considered to have the following text appended to it:
In the case of a CA module based on the DVB common interface, this event shall only be generated when module initialisation has been completed. Hence an application has no means to detect when a module is inserted but has not yet been initialised.
The following text:
This event is generated as part of the Host Control functionality in the Common Interface /CA0 to signal that an elementary stream should be substituted with an other one. This event is intended for data services only. Television services that are presented using a high level media player API (whose implementation implicitly handles descrambling) will also have this event handled implicitly by that implementation.
Is considered to be replaced with the following:
In systems based upon the DVB Common Interface this event is generated in response to the Host Control replace /clear_replace requests. NOTE:This event is for information only. The platform is responsible for implementing the requests from the CA system. See also R206.
This class is changed to inherit from CAEvent and not from DescramblerEvent.
This class is changed to inherit from CAEvent and not from DescramblerEvent.
The following text:
This event is generated as part of the Host Control functionality in the Common Interface /CA0.
Is considered to be replaced with the following:
In systems based upon the DVB Common Interface this event is generated in response to the Host Control tune request.
NOTE 1:This event is only guaranteed to be delivered to applications that survive the service selection caused by the Host Control tune request (see 11.6.4,"Conditional Access API"on page 125).
NOTE 2:This event is for information only.The platform is responsible for implementing the service selection autonomously in response to the request from the CA system.
|
||||||||||
PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES |