gupnp_control_point_callback_set
(PECL gupnp >= 0.1.0)
gupnp_control_point_callback_set — Définit la fonction de rappel pour le point de contrôle
Description
$cpoint
, int $signal
, mixed $callback
[, mixed $arg
] )Définit la fonction de rappel pour le point de contrôle pour un signal donné.
Liste de paramètres
-
cpoint
-
Un identifiant de point de contrôle, retourné par la fonction gupnp_control_point_new().
-
signal
-
La valeur du signal. Le signal peut prendre une des valeurs suivantes :
-
GUPNP_SIGNAL_DEVICE_PROXY_AVAILABLE
- Émis lorsqu'un nouveau périphérique devient disponible.
-
GUPNP_SIGNAL_DEVICE_PROXY_UNAVAILABLE
- Émis lorsqu'un périphérique devient indisponible.
-
GUPNP_SIGNAL_SERVICE_PROXY_AVAILABLE
- Émis lorsqu'un nouveau service devient disponible.
-
GUPNP_SIGNAL_SERVICE_PROXY_UNAVAILABLE
- Émis lorsqu'un service devient indisponible.
-
-
callback
-
La fonction de rappel pour un signal spécifique. Typiquement, la fonction de rappel prend 2 arguments. Le paramètre
proxy
sera le premier, etarg
, le second. -
arg
-
Données utilisateur pour la fonction de rappel
callback
.
Valeurs de retour
Cette fonction retourne TRUE
en cas de
succès ou FALSE
si une erreur survient.
Exemples
Exemple #1 Création d'un nouveau contexte UPnP et commence la recherche
<?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); } /* Crée un contexte UPnP */ $context = gupnp_context_new(); if (!$context) { die("Erreur lors de la création du contexte GUPnP\n"); } /* Nous sommes intéressé par tout ! */ $cp = gupnp_control_point_new($context, "ssdp:all"); gupnp_control_point_callback_set($cp, GUPNP_SIGNAL_DEVICE_PROXY_AVAILABLE, 'device_proxy_available_cb'); /* Démarre la recherche */ gupnp_control_point_browse_start($cp); ?>
Erreurs / Exceptions
Émets une alerte de type E_WARNING si la fonction de rappel n'est pas valide.
Voir aussi
- gupnp_control_point_new() - Crée un nouveau point de contrôle
- gupnp_control_point_browse_start() - Commence la recherche