gupnp_control_point_callback_set
(PECL gupnp >= 0.1.0)
gupnp_control_point_callback_set — Set control point callback
説明
bool gupnp_control_point_callback_set
( resource
$cpoint
, int $signal
, mixed $callback
[, mixed $arg
] )Set control point callback function for signal.
パラメータ
-
cpoint -
A control point identifier, returned by gupnp_control_point_new().
-
signal -
The value of signal. Signal can be one of the following values:
-
GUPNP_SIGNAL_DEVICE_PROXY_AVAILABLE - Emitted whenever a new device has become available.
-
GUPNP_SIGNAL_DEVICE_PROXY_UNAVAILABLE - Emitted whenever a device is not available any more.
-
GUPNP_SIGNAL_SERVICE_PROXY_AVAILABLE - Emitted whenever a new service has become available.
-
GUPNP_SIGNAL_SERVICE_PROXY_UNAVAILABLE - Emitted whenever a service is not available any more.
-
-
callback -
The callback function for the certain signal. Typically, callback function takes on two parameters. The
proxyparameter's identifier being the first, and theargsecond. -
arg -
User data for
callback.
返り値
成功した場合に TRUE を、失敗した場合に FALSE を返します。
例
例1 Create new UPnP context and start browsing
<?php
function device_proxy_available_cb($proxy, $arg)
{
$info = gupnp_device_info_get($proxy);
$type = $info['device_type'];
$location = $info['location'];
printf("Device available:\n");
printf("type: %s\n", $type);
printf("location: %s\n", $location);
}
/* Create the UPnP context */
$context = gupnp_context_new();
if (!$context) {
die("Error creating the GUPnP context\n");
}
/* We're interested in everything */
$cp = gupnp_control_point_new($context, "ssdp:all");
gupnp_control_point_callback_set($cp,
GUPNP_SIGNAL_DEVICE_PROXY_AVAILABLE, 'device_proxy_available_cb');
/* Start for browsing */
gupnp_control_point_browse_start($cp);
?>
エラー / 例外
Issues E_WARNING with not valid callback function.
参考
- gupnp_control_point_new() - Create a new control point
- gupnp_control_point_browse_start() - Start browsing
忘却曲線を使ってこの関数を確実に記憶に残す
