org.davic.mpeg
Interface NotAuthorizedInterface

All Known Implementing Classes:
NotAuthorizedException

public interface NotAuthorizedInterface

NotAuthorizedInterface shall be implemented by classes which can report failure to access broadcast content due to failure to descramble that content. The interface provides an ability for an application to find out some information about the reason for the failure.


Field Summary
static int COMMERCIAL_DIALOG
          Minor reason for POSSIBLE_UNDER_CONDITIONS - user dialog needed for payment
static int ELEMENTARY_STREAM
          The component to which access was refused was an MPEG elementary stream
static int FREE_PREVIEW_DIALOG
          Minor reason for POSSIBLE_UNDER_CONDITIONS - user dialog needed to explain about free preview.
static int GEOGRAPHICAL_BLACKOUT
          Minor reason for NOT_POSSIBLE - not allowed for geographical reasons
static int MATURITY_RATING
          Minor reason for NOT_POSSIBLE - user does not have suitable maturity
static int MATURITY_RATING_DIALOG
          Minor reason for POSSIBLE_UNDER_CONDITIONS - user dialog needed for maturity
static int NO_ENTITLEMENT
          Minor reason for NOT_POSSIBLE - user does not have an entitlement
static int NOT_POSSIBLE
          Major reason - access not possible
static int OTHER
          Minor reason for both POSSIBLE_UNDER_CONDITIONS and NOT_POSSIBLE.
static int POSSIBLE_UNDER_CONDITIONS
          Major reason - access may be possible under certain conditions.
static int SERVICE
          The component to which access was refused was a MPEG Program/DVB Service
static int TECHNICAL
          Minor reason for NOT_POSSIBLE - a technical reason of some kind
static int TECHNICAL_DIALOG
          Minor reason for POSSIBLE_UNDER_CONDITIONS - user dialog needed for technical purposes.
 
Method Summary
 int[] getReason(int index)
          Returns the reason(s) why descrambling was not possible.
 int getType()
           
 

Field Detail

POSSIBLE_UNDER_CONDITIONS

static final int POSSIBLE_UNDER_CONDITIONS
Major reason - access may be possible under certain conditions.

See Also:
Constant Field Values

NOT_POSSIBLE

static final int NOT_POSSIBLE
Major reason - access not possible

See Also:
Constant Field Values

COMMERCIAL_DIALOG

static final int COMMERCIAL_DIALOG
Minor reason for POSSIBLE_UNDER_CONDITIONS - user dialog needed for payment

See Also:
Constant Field Values

MATURITY_RATING_DIALOG

static final int MATURITY_RATING_DIALOG
Minor reason for POSSIBLE_UNDER_CONDITIONS - user dialog needed for maturity

See Also:
Constant Field Values

TECHNICAL_DIALOG

static final int TECHNICAL_DIALOG
Minor reason for POSSIBLE_UNDER_CONDITIONS - user dialog needed for technical purposes.

See Also:
Constant Field Values

FREE_PREVIEW_DIALOG

static final int FREE_PREVIEW_DIALOG
Minor reason for POSSIBLE_UNDER_CONDITIONS - user dialog needed to explain about free preview.

See Also:
Constant Field Values

NO_ENTITLEMENT

static final int NO_ENTITLEMENT
Minor reason for NOT_POSSIBLE - user does not have an entitlement

See Also:
Constant Field Values

MATURITY_RATING

static final int MATURITY_RATING
Minor reason for NOT_POSSIBLE - user does not have suitable maturity

See Also:
Constant Field Values

TECHNICAL

static final int TECHNICAL
Minor reason for NOT_POSSIBLE - a technical reason of some kind

See Also:
Constant Field Values

GEOGRAPHICAL_BLACKOUT

static final int GEOGRAPHICAL_BLACKOUT
Minor reason for NOT_POSSIBLE - not allowed for geographical reasons

See Also:
Constant Field Values

OTHER

static final int OTHER
Minor reason for both POSSIBLE_UNDER_CONDITIONS and NOT_POSSIBLE. Another reason.

See Also:
Constant Field Values

SERVICE

static final int SERVICE
The component to which access was refused was a MPEG Program/DVB Service

See Also:
getType(), Constant Field Values

ELEMENTARY_STREAM

static final int ELEMENTARY_STREAM
The component to which access was refused was an MPEG elementary stream

See Also:
getType(), Constant Field Values
Method Detail

getType

int getType()
Returns:
SERVICE or ELEMENTARY_STREAM to indicate that either a service (MPEG program) or one or more elementary streams could not be descrambled.

getReason

int[] getReason(int index)
                throws java.lang.IndexOutOfBoundsException
Returns the reason(s) why descrambling was not possible.

Parameters:
index - If the component to which access failed is a Service, index shall be 0. Otherwise index shall refer to one stream in the set returnedby getElementaryStreams().
Returns:
an array of length 2 where the first element of the array is the major reason and the second element of the array is the minor reason.
Throws:
java.lang.IndexOutOfBoundsException - If the component to which access failed is a Service, this exception will be thrown if index is non zero. If the component(s) to which access failed was a (set of) elementary streams then this exception will be thrown where index is beyond the size of the array returned by getElementaryStreams. // * @see NotAuthorizedInterface#getElementaryStreams