|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectit.dtt.ca.CAObject
it.dtt.ca.CAManager
public abstract class CAManager
This class provides access to the Conditional Access (CA) functionalities of the STB. It allows to perform five kinds of operations:
Constructor Summary | |
---|---|
protected |
CAManager(org.davic.resources.ResourceClient resourceClient)
Creates the CAManager object and the associated new CASession. |
Method Summary | |
---|---|
void |
addCAListener(CAListener listener)
Register a listener to the Conditional Access related events. |
abstract java.lang.String |
getCAProvider()
Get the name of the CA provider ("Nagra", "Irdeto", etc). |
abstract java.lang.String |
getCARevision()
Get the revision of the CA kernel. |
abstract java.lang.String |
getCAVersion()
Get the version of the CA kernel. |
org.davic.resources.ResourceClient |
getClient()
Get the client that requested this object. |
Product |
getCurrentEvent()
Deprecated. replaced by getCurrentProduct Retrieve a Product object describing the event currently on air, independently of the way it is offered (Impulse Pay per View, Ordered Pay per View, Pay per Time, etc.) A NULL value is returned if no service is currently selected in this service context or of the currently selected service context is not something which can be bought through the CA system represented by this CAManager. In a multi-tuner receiver, the target service is the one in which the application itself is broadcasted. Note: this method has been replaced by the getCurrentProducts method but is retained here for backward compatability. |
Product[] |
getCurrentProducts()
Retrieve Product objects describing the event currently on air(in the default Service Context), independently of the way it is offered (Impulse Pay per View, Ordered Pay per View, Pay per Time, etc.) |
Product[] |
getCurrentProducts(javax.tv.service.selection.ServiceContext serviceContext)
Retrieve Product objects describing the event currently on air(in the specified Service Context), independently of the way it is offered (Impulse Pay per View, Ordered Pay per View, Pay per Time, etc.). |
java.lang.String |
getIrdSerialNumber()
Retrieves serial number of the set top box. |
Product |
getNextEvent()
Deprecated. replaced by getNextProduct Retrieve a Product object describing the event that will be next on air, independently of the way it is offered (Impulse Pay per View, Ordered Pay per View, Pay per Time, etc.). A NULL value is returned if no service is currently selected in this service context or of the currently selected service context is not something which can be bought through the CA system represented by this CAManager. In a multi-tuner receiver, the target service is the one in which the application itself is broadcasted. Note: this method has been replaced by the getNextProducts method but is retained here for backward compatability. |
Product[] |
getNextProducts()
Retrieve Product objects describing the service that will be next on air, independently of the way it is offered (Impulse Pay per View, Ordered Pay per View, Pay per Time, etc.) |
Product[] |
getNextProducts(javax.tv.service.selection.ServiceContext serviceContext)
Retrieve Product objects describing the service that will be next on air(in the specified Service Context), independently of the way it is offered (Impulse Pay per View, Ordered Pay per View, Pay per Time, etc.) |
ParentalControlLevel |
getParentalControlLevel()
Get the current parental control level. |
abstract Pin[] |
getPins()
Get all Personal Identification Numbers that are stored on the STB. |
abstract Slot[] |
getSlots()
This method returns an array containing references to the smart card reader slots present in the set top box (normally just one). |
ResponseEvent |
performRequest(CARequest request,
int timeoutms)
Perform the specified request synchronously and return the response. |
void |
performRequest(CARequest request,
ResponseListener listener)
Perform the specified request asynchronously and send the response to the given ResponseListener. |
void |
performRequest(CARequest request,
ResponseListener listener,
org.dvb.net.rc.ConnectionParameters params,
org.dvb.net.rc.ConnectionListener rclistener)
Perform the specified request asynchronously using a return channel connection and send the response to the given ResponseListener. |
void |
removeCAListener()
Deprecated. Removes the last CAListener attached. If no listener is attached an exception is thrown. If listener does not exist, do nothing. |
void |
removeCAListener(CAListener listener)
Removes the specified CAListener if attached, otherwise an exception is thrown. |
void |
setCAListener(CAListener listener)
Deprecated. use addCAListener Register a listener to the Conditional Access related events. If listener already exists, do nothing. |
void |
setParentalControlLevel(ParentalControlLevel level,
byte[] pin)
Set the parental control level. |
Methods inherited from class it.dtt.ca.CAObject |
---|
checkSession, closeSession, getParent, getSession, sessionClosed, sessionClosing |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
protected CAManager(org.davic.resources.ResourceClient resourceClient)
CAManager
object and the associated new CASession.
The circumstances when the ResourceClient is called should be defined in the CA system specific documentation.
This class is not a singleton. A device supporting multiple CA kernels shall support one instance of this class for each supported CA kernel.
resourceClient
- the resource client.Method Detail |
---|
public org.davic.resources.ResourceClient getClient()
ResourceProxy.getClient()
public abstract Pin[] getPins() throws SessionClosedException
SessionClosedException
- if the session is closed.public java.lang.String getIrdSerialNumber() throws SessionClosedException
SessionClosedException
- thrown if the session was closed.public abstract Slot[] getSlots() throws SessionClosedException
SessionClosedException
- thrown if the session was closed.Slot
public void addCAListener(CAListener listener) throws SessionClosedException
listener
- the only listener to CA related events
SessionClosedException
- thrown if the session was closed.public void setCAListener(CAListener listener) throws SessionClosedException
listener
- the only listener to CA related events
SessionClosedException
- thrown if the session was closed.public void removeCAListener(CAListener listener) throws SessionClosedException, NoListenerAttachedException
SessionClosedException
- thrown if the session was closed.
NoListenerAttachedException
- thrown if no listener is currently attachedpublic void removeCAListener() throws SessionClosedException, NoListenerAttachedException
SessionClosedException
- thrown if the session was closed.
NoListenerAttachedException
- thrown if no listener is currently attachedpublic Product getCurrentEvent() throws SessionClosedException
SessionClosedException
- thrown if the session was closed.public Product getNextEvent() throws SessionClosedException
SessionClosedException
- thrown if the session was closed.public Product[] getCurrentProducts() throws SessionClosedException
SessionClosedException
- thrown if the session was closed.public Product[] getCurrentProducts(javax.tv.service.selection.ServiceContext serviceContext) throws SessionClosedException, NoSuchServiceContextException
SessionClosedException
- thrown if the session was closed.
NoSuchServiceContextException
- - if the indicated Service Context does not exist or is not available.public Product[] getNextProducts() throws SessionClosedException
SessionClosedException
- thrown if the session was closed.public Product[] getNextProducts(javax.tv.service.selection.ServiceContext serviceContext) throws SessionClosedException, NoSuchServiceContextException
SessionClosedException
- thrown if the session was closed.
NoSuchServiceContextException
- - if the indicated Service Context does not exist or is not available.public ResponseEvent performRequest(CARequest request, int timeoutms) throws SessionClosedException, InvalidRequestParametersException, InvalidTransactionDataException, CardNotFoundException, CARequestAlreadyStartedException, TimeoutExpiredException
request
- the request which should be performed.timeoutms
- the required timeout in milliseconds, after which the TimeoutExpiredException is thrown.
SessionClosedException
- thrown if the session was closed.
InvalidTransactionDataException
- if some data used for transaction is wrong (ie. any null field for credit card data)
InvalidRequestParametersException
- if the request paramters are invalid.
CardNotFoundException
- if the correct card is not inserted.
TimeoutExpiredException
- if the timeout expires.
CARequestAlreadyStartedException
- if the request is already startedpublic void performRequest(CARequest request, ResponseListener listener) throws SessionClosedException, InvalidRequestParametersException, InvalidTransactionDataException, CardNotFoundException, CARequestAlreadyStartedException
request
- the request which should be performed.listener
- the object waiting for the response to this request.
SessionClosedException
- thrown if the session was closed.
InvalidRequestParametersException
- if the request paramters are invalid.
InvalidTransactionDataException
- if some data used for transaction is wrong (ie. any null field for credit card data)
CardNotFoundException
- if the correct card is not inserted.
CARequestAlreadyStartedException
- if the request is already startedpublic void performRequest(CARequest request, ResponseListener listener, org.dvb.net.rc.ConnectionParameters params, org.dvb.net.rc.ConnectionListener rclistener) throws SessionClosedException, InvalidRequestParametersException, InvalidTransactionDataException, CardNotFoundException, CARequestAlreadyStartedException
request
- the request which should be performedlistener
- the object waiting for the response to this request.params
- the parameters used for the return channel connectionrclistener
- the object waiting for the return channel related events
SessionClosedException
- thrown if the session was closed.
InvalidRequestParametersException
- if the request paramters are invalid.
InvalidTransactionDataException
- if some data used for transaction is wrong (ie. any null field for credit card data)
CardNotFoundException
- if the correct card is not inserted.
CARequestAlreadyStartedException
- if the request is already startedpublic ParentalControlLevel getParentalControlLevel() throws SessionClosedException
SessionClosedException
- thrown if the session was closed.public void setParentalControlLevel(ParentalControlLevel level, byte[] pin) throws SessionClosedException, InvalidPinException
level
- the new parental control level.pin
- the parental control pin.
SessionClosedException
- thrown if the session was closed.
InvalidPinException
- thrown if the specified PIN is invalid.public abstract java.lang.String getCAProvider()
public abstract java.lang.String getCAVersion()
public abstract java.lang.String getCARevision()
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |