gupnp_control_point_callback_set
(PECL gupnp >= 0.1.0)
gupnp_control_point_callback_set — Establece el punto de control callback
Descripción
$cpoint
, int $signal
, mixed $callback
[, mixed $arg
] ) : boolEstablece el punto de control de la función callback por cada señal.
Parámetros
-
cpoint -
Un identificador de punto de control, devuelto por gupnp_control_point_new().
-
signal -
El valor de la señal. La señal puede ser uno de los siguientes valores:
-
GUPNP_SIGNAL_DEVICE_PROXY_AVAILABLE - Emitido siempre que un nuevo dispositivo esté disponible.
-
GUPNP_SIGNAL_DEVICE_PROXY_UNAVAILABLE - Emitido siempre que un dispositivo ha dejado de estar disponible.
-
GUPNP_SIGNAL_SERVICE_PROXY_AVAILABLE - Emitido siempre que un nuevo servicio esté disponible.
-
GUPNP_SIGNAL_SERVICE_PROXY_UNAVAILABLE - Emitido siempre que un servicio ha dejado de estar disponible.
-
-
callback -
La función callback para cierta señal. Típicamente, la función calback carga dos parámetros. El primero es el de identificador del
proxyy el segundo es elarg. -
arg -
Dato de usuario para el
callback.
Valores devueltos
Devuelve TRUE en caso de éxito o FALSE en caso de error.
Ejemplos
Ejemplo #1 Crea un nuevo contexto UPnP e inicia el navegador
<?php
function device_proxy_available_cb($proxy, $arg)
{
$info = gupnp_device_info_get($proxy);
$type = $info['device_type'];
$location = $info['location'];
printf("Dispositivo Disponible:\n");
printf("tipo: %s\n", $type);
printf("ubicación: %s\n", $location);
}
/* Crea un contexto UPnP */
$context = gupnp_context_new();
if (!$context) {
die("error creando el contexto GUPnP\n");
}
/* Estamos interesados en todo */
$cp = gupnp_control_point_new($context, "ssdp:all");
gupnp_control_point_callback_set($cp,
GUPNP_SIGNAL_DEVICE_PROXY_AVAILABLE, 'device_proxy_available_cb');
/* Empieza a navegar */
gupnp_control_point_browse_start($cp);
?>
Errores/Excepciones
Lanza un E_WARNING cuando la función callback es inválida.
Ver también
- gupnp_control_point_new() - Crea un nuevo punto de control
- gupnp_control_point_browse_start() - Comienza la navegación
add a note
