org.dvb.service.selection
Interface DvbServiceContext

All Superinterfaces:
javax.tv.service.selection.ServiceContext

public interface DvbServiceContext
extends javax.tv.service.selection.ServiceContext

An extension to ServiceContext permitting the discovery of the network interface (if any) being used by a service context. When a service is selected in a service context, the resource priority of the service context shall be initialised to the resource priority of the service where one is set. Where a service does not have a resource priority, the priority of the service context shall be initialised to 128.


Method Summary
 NetworkInterface getNetworkInterface()
          Return the NetworkInterface reserved by this ServiceContext.
 int getPriority()
          Get the resource priority for this service context.
 void setDefaultVideoTransformation(VideoTransformation vt)
          Sets the default video transformation to be applied to the new service following a service selection operation.
 void setPriority(int priority)
          Set the resource priority for this service context.
 
Methods inherited from interface javax.tv.service.selection.ServiceContext
addListener, destroy, getService, getServiceContentHandlers, removeListener, select, select, stop
 

Method Detail

getNetworkInterface

NetworkInterface getNetworkInterface()
Return the NetworkInterface reserved by this ServiceContext. The NetworkInterface instance returned shall be .equals() to one of those returned by NetworkInterfaceManager.getNetworkInterfaces().

Returns:
a NetworkInterface object or null if this ServiceContext has no NetworkInterface reserved

setDefaultVideoTransformation

void setDefaultVideoTransformation(VideoTransformation vt)
Sets the default video transformation to be applied to the new service following a service selection operation. The identity of the last application to call this method for each service context instance shall be remembered by the GEM terminal. If this is set then the presentation of the video of the new service will use the video transformation of the existing service until it is known whether that application survives. If that application survives then this transformation shall be applied to the video of the new service. If that application does not survive then the video transformation of the new service will be reset to the default for the platform and the value set by the call to this method discarded. This method shall have no effect if the ServiceMediaHandler for the service context is a component based player when service selection happens.

Parameters:
vt - the video default transformation or null to reset to the default for the platform
Since:
MHP 1.1.2

getPriority

int getPriority()
Get the resource priority for this service context. The priority is a number between 0 and 255.

Returns:
the resource priority for this service context
Since:
MHP 1.2

setPriority

void setPriority(int priority)
Set the resource priority for this service context. The priority is a number between 0 and 255.

Parameters:
priority - the resource priority for this service context
Throws:
java.lang.IllegalArgumentException - if the priority is outside this specified range
Since:
MHP 1.2