gupnp_service_proxy_add_notify(3) [php man page]

GUPNP_SERVICE_PROXY_ADD_NOTIFY(3)					 1					 GUPNP_SERVICE_PROXY_ADD_NOTIFY(3)

gupnp_service_proxy_add_notify - Sets up callback for variable change notification

SYNOPSIS

       bool gupnp_service_proxy_add_notify (resource  $proxy, string  $value, int  $type, mixed  $callback, [mixed  $arg])

DESCRIPTION

	Sets up callback to be called whenever a change notification for variable is recieved.

PARAMETERS

	      o $proxy
		- A service proxy identifier.

	      o $value
		- The variable to add notification for.

	      o $type
		- The type of the variable. Type can be one of the following values:

		     o GUPNP_TYPE_BOOLEAN - Type of the variable is boolean.

		     o GUPNP_TYPE_INT - Type of the variable is integer.

		     o GUPNP_TYPE_LONG - Type of the variable is long.

		     o GUPNP_TYPE_DOUBLE - Type of the variable is double.

		     o GUPNP_TYPE_FLOAT - Type of the variable is float.

		     o GUPNP_TYPE_STRING - Type of the variable is string.

	      o $callback
		-  The	callback  to  call  when variable changes. Typically, callback function takes on three parameters. The $variable parameter
		being the first, $value parameter being the second, and the $arg is third.

	      o $arg
		- User data for $callback.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

SEE ALSO

       gupnp_service_proxy_remove_notify(3).

PHP Documentation Group 											 GUPNP_SERVICE_PROXY_ADD_NOTIFY(3)

GUPNP_CONTROL_POINT_CALLBACK_SET(3)					 1				       GUPNP_CONTROL_POINT_CALLBACK_SET(3)

gupnp_control_point_callback_set - Set control point callback

SYNOPSIS

       bool gupnp_control_point_callback_set (resource	$cpoint, int  $signal, mixed  $callback, [mixed  $arg])

DESCRIPTION

	Set control point callback function for signal.

PARAMETERS

	      o $cpoint
		- A control point identifier, returned by gupnp_control_point_new(3).

	      o $signal
		- The value of signal. Signal can be one of the following values:

		     o GUPNP_SIGNAL_DEVICE_PROXY_AVAILABLE - Emitted whenever a new device has become available.

		     o GUPNP_SIGNAL_DEVICE_PROXY_UNAVAILABLE - Emitted whenever a device is not available any more.

		     o GUPNP_SIGNAL_SERVICE_PROXY_AVAILABLE - Emitted whenever a new service has become available.

		     o GUPNP_SIGNAL_SERVICE_PROXY_UNAVAILABLE - Emitted whenever a service is not available any more.

	      o $callback
		- The callback function for the certain signal. Typically, callback function takes on two parameters. The $proxy parameter's iden-
		tifier being the first, and the $arg second.

	      o $arg
		- User data for $callback.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #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:
");
		  printf("type:     %s
", $type);
		  printf("location: %s
", $location);
	      }

	      /* Create the UPnP context */
	      $context = gupnp_context_new();

	      if (!$context) {
	       die("Error creating the GUPnP context
");
	      }

	      /* 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);

	      ?>

ERRORS
/EXCEPTIONS
	Issues E_WARNING with not valid callback function.

SEE ALSO

       gupnp_control_point_new(3), gupnp_control_point_browse_start(3).

PHP Documentation Group 										       GUPNP_CONTROL_POINT_CALLBACK_SET(3)