ITunerSession

Tune to a specified program.

Automatically cancels pending tune(), scan() or step().If the method returns OK, tuneFailed or currentProgramInfoChanged callback must be called.

Tune(seek)to the next valid program on the "air".

This might more naturally be called "seek" but for legacy reasons, the entry point remains "scan".This should not be confused with the actual scan operation(where the radio seeks through programs in a loop until user chooses to stay on one of them)nor background scan operation(that a tuner may do in order to locate all available programs.This function is meant to advance to the next detected program and stay there.

Automatically cancels pending tune(), scan() or step().If the method returns OK, tuneFailed or currentProgramInfoChanged callback must be called.

The skipSubChannel parameter is used to skip digital radio subchannels:- HD Radio SPS;- DAB secondary service.

As an implementation detail, the HAL has the option to perform an actual seek or select the next program from the list retrieved in the background, if one is not stale.

Tune to the adjacent channel, which may not be occupied by any program.

Automatically cancels pending tune(), scan() or step().If the method returns OK, tuneFailed or currentProgramInfoChanged callback must be called.

Cancel a pending tune(), scan() or step().

If there is no such operation running, the call must be ignored.

Applies a filter to the program list and starts sending program list updates over onProgramListUpdated callback.

There may be only one updates stream active at the moment.Calling this method again must result in cancelling the previous update request.

This call clears the program list on the client side, the HAL must send the whole list again.

If the program list scanning hardware(i.e.background tuner)is unavailable at the moment, the call must succeed and start updates when it becomes available.

Stops sending program list updates.

Fetches the current setting of a given config flag.

The success/failure result must be consistent with setConfigFlag.

Sets the config flag.

The success/failure result must be consistent with isConfigFlagSet.

Generic method for setting vendor-specific parameter values.The framework does not interpret the parameters, they are passed in an opaque manner between a vendor application and HAL.

Framework does not make any assumptions on the keys or values, other than ones stated in VendorKeyValue documentation(a requirement of key prefixes).

For each pair in the result vector, the key must be one of the keys contained in the input(possibly with wildcards expanded), and the value must be a vendor-specific result status(i.e.the string "OK" or an error code). The implementation may choose to return an empty vector, or only return a status for a subset of the provided inputs, at its discretion.

Application and HAL must not use keys with unknown prefix.In particular, it must not place a key-value pair in results vector for unknown key from parameters vector - instead, an unknown key should simply be ignored.In other words, results vector may contain a subset of parameter keys(however, the framework doesn't enforce a strict subset - the only formal requirement is vendor domain prefix for keys).

Generic method for retrieving vendor-specific parameter values.The framework does not interpret the parameters, they are passed in an opaque manner between a vendor application and HAL.

Framework does not cache set/get requests, so it's allowed for getParameter to return a different value than previous setParameter call.

The syntax and semantics of keys are up to the vendor(as long as prefix rules are obeyed). For instance, vendors may include some form of wildcard support.In such case, result vector may be of different size than requested keys vector.However, wildcards are not recognized by framework and they are passed as-is to the HAL implementation.

Unknown keys must be ignored and not placed into results vector.

Closes the session.

The call must not fail and must only be issued once.

After the close call is executed, no other calls to this interface are allowed.