Package: android.hardware.cas@1.0

ICas

interface ICas

ICas is the API to control the cas system and is accessible from both Java and native level.It is used to manage sessions, provision/refresh the cas system, and process the EMM/ECM messages.It also allows bi-directional, scheme-specific communications between the client and the cas system.

Methods

setPrivateData

setPrivateData (vec<uint8_t> pvtData)
generates (Status status)

Provide the CA private data from a CA_descriptor in the conditional access table to a CasPlugin.

Details
Parameters
pvtData
a byte array containing the private data, the format of which is scheme-specific and opaque to the framework.
Generates
status
the status of the call.

openSession

openSession ()
generates (Status status, HidlCasSessionId sessionId)

Open a session to descramble one or more streams scrambled by the conditional access system.

Details
Generates
status
the status of the call.
sessionId
the id of the newly opened session.

closeSession

closeSession (HidlCasSessionId sessionId)
generates (Status status)

Close a session.

Details
Parameters
sessionId
the id of the session to be closed.
Generates
status
the status of the call.

setSessionPrivateData

setSessionPrivateData (HidlCasSessionId sessionId, vec<uint8_t> pvtData)
generates (Status status)

Provide the CA private data from a CA_descriptor in the program map table to a session.

Details
Parameters
sessionId
the id of the session which the private data applies to.
pvtData
a byte array containing the private data, the format of which is scheme-specific and opaque to the framework.
Generates
status
the status of the call.

processEcm

processEcm (HidlCasSessionId sessionId, vec<uint8_t> ecm)
generates (Status status)

Process an ECM from the ECM stream for this session’s elementary stream.

Details
Parameters
sessionId
the id of the session which the ecm data applies to.
ecm
a byte array containing the ecm data.
Generates
status
the status of the call.

processEmm

processEmm (vec<uint8_t> emm)
generates (Status status)

Process an in-band EMM from the EMM stream.

Details
Parameters
emm
a byte array containing the emm data.
Generates
status
the status of the call.

sendEvent

sendEvent (int32_t event, int32_t arg, vec<uint8_t> eventData)
generates (Status status)

Send an scheme-specific event to the CasPlugin.

Details
Parameters
event
an integer denoting a scheme-specific event to be sent.
arg
a scheme-specific integer argument for the event.
eventData
Generates
status
the status of the call.

provision

provision (string provisionString)
generates (Status status)

Initiate a provisioning operation for a CA system.

Details
Parameters
provisionString
string containing information needed for the provisioning operation, the format of which is scheme and implementation specific.
Generates
status
the status of the call.

refreshEntitlements

refreshEntitlements (int32_t refreshType, vec<uint8_t> refreshData)
generates (Status status)

Notify the CA system to refresh entitlement keys.

Details
Parameters
refreshType
the type of the refreshment.
refreshData
private data associated with the refreshment.
Generates
status
the status of the call.

release

release ()
generates (Status status)

Release the descrambler instance.

Details
Generates
status
the status of the call.