org.ocap.hn.service

Interface ServiceResolutionHandler

public interface ServiceResolutionHandler

This interface provides a handler that can be registered with an implementation to provide a Locator for an otherwise non-tunable ChannelContentItem, such as an SDV channel. If a ServiceResolutionHandler is not registered then the implementation fails any attempts to tune to such channels.

This interface also provides a handler that can be used by the implementation to notify the application that tuning attempts with the application provided locator for a broadcast channel item have failed.

Note: This interface is intended to be used by applications which do not provide a DVB SPI SelectionProvider for the "ocap" scheme.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	notifyTuneFailed(ChannelContentItem channel) Notifies the application of a tuning failure for a remote streaming request for a ChannelContentItem.
boolean	resolveChannelItem(ChannelContentItem channel) Requests that the application provide tuning parameters for the ChannelContentItem.

Method Detail

notifyTuneFailed

boolean notifyTuneFailed(ChannelContentItem channel)

Notifies the application of a tuning failure for a remote streaming request for a ChannelContentItem.

Parameters:

channel - A ChannelContentItem

Returns:

If the return value is true, the implementation SHALL retry tuning using the current value of the ChannelContentItem's tuning locator; if the return value is false or the tuning locator is null, the implementation SHALL fail the tuning request.

resolveChannelItem

boolean resolveChannelItem(ChannelContentItem channel)

Requests that the application provide tuning parameters for the ChannelContentItem. When the application is able to resolve the item to a tunable channel, the application calls the ChannelContentItem.setTuningLocator method, and this method returns true.

Parameters:

channel - A ChannelContentItem

Returns:

true if application resolved the channel item and updated the ChannelContentItem locator, false otherwise