SiliconDust HDHomeRun Bedienungsanleitung PDF herunterladen (Seite 21)

The hdhomerun_device_stream_start/stop() APIs call hdhomerun_device_set_tuner_target()

internally as needed.

Option 2: external video socket support:

For applications with existing UDP or RTP video support use

hdhomerun_device_set_tuner_target() to set the target to the listening UDP port.

When streaming is no longer required use the same function to set the target to “none”.

Resource lock:

The resource lock API is used to prevent conflicts when there are multiple hosts on the network

controlling the same set of tuners.

Low level: use hdhomerun_device_tuner_lockkey_request() to request exclusive control of the

tuner. This function will return success (1) if the request was successful, reject (0) if the tuner is

in use by anther host, or error (-1) if a communication error occurs.

When the tuner lock is no longer required use hdhomerun_device_tuner_lockkey_release() to

release the resource lock.

The hdhomerun_device_tuner_lockkey_force() API will cause a resource lock to be released

regardless of which host owns the lock. This function should only be called if the user has been

presented with a dialog and the user has explicitly requested that the lock be overridden.

The HDHomeRun will self expire the resource lock if not streaming and no commands are received

in a 30s period. If the host application crashes without releasing the resource lock this timeout will

allow the tuner to be used again. The exception - if the tuner is streaming video and the host has

a firewall that prevents ICMP port unreachable messages the tuner will not be informed that the

video is no longer being accepted by the host. Streaming will continue and the tuner will maintain

the lock.

To avoid this situation use the Device Selector API to request the resource lock. This will auto-

detect and release dead locks - see Device Selector API section below.

Note: the detection and automatic release of dead resource locks is planned to be moved to

hdhomerun_device_tuner_lockkey_request(). If this affects your application please contact

Device Selector API

The Device Selector API is used to automatically select and lock an available tuner from a pool of

tuners - documented in device_selector.h.

A pool is typically all tuners on the local network that have the same signal source.

Setup:

Use hdhomerun_device_selector_create() to create the selector object.

Use hdhomerun_device_selector_add_device() to add a device to the selection pool.

Tuner selection:

Start: use hdhomerun_device_selector_choose_and_lock() to find and lock an available tuner.

Stop: use hdhomerun_device_tuner_lockkey_release() to release the lock when the tuner is no

longer required.

Channel change: there are two options for handling the resource lock when changing channel:

1 2 ... 16 17 18 19 20 21 22 23 24

Keine Kommentare

SiliconDust HDHomeRun Bedienungsanleitung Seite 21