GUPnP-1.6 ▶ GUPnP ▶ ServiceProxyAction

constructor

• new ServiceProxyAction(action: string, ___: any[]): ServiceProxyAction

  Parameters

  • action: string
  • ___: any[]

  Returns ServiceProxyAction

Static$gtype

Since 1.6.6add_argument

• add_argument(name: string, value: any): ServiceProxyAction

  Append name to the list of arguments used by action

  Parameters

  • name: string

    The name of the argument

  • value: any

    The value of the argument

  Returns ServiceProxyAction

  action for convenience.

  Since

  1.6.6

Since 1.2.0get_result_hash

• get_result_hash(
      out_hash: { [key: string]: GObject.Value },
  ): [boolean, { [key: string]: GObject.Value }]

  See gupnp_service_proxy_action_get_result(); this version takes a GLib.HashTable for runtime generated parameter lists.

  The out_hash needs to be pre-initialized with key value pairs denoting the argument to retrieve and an empty GObject.Value initialized to hold the wanted type with g_value_init().

  void on_action_finished(GObject *object, GAsyncResult *res, gpointer user_data)
  {
      GUPnPServiceProxyAction *action;
      GError *error;
  
      action = gupnp_service_proxy_call_action_finish (GUPNP_SERVICE_PROXY (object),
                                                       res,
                                                       &error);
  
      if (error != NULL) {
               g_print ("Call failed: %s", error->message);
               g_clear_error (&error);
               return;
      }
  
      GValue play_mode = G_VALUE_INIT;
      g_value_init(&play_mode, G_TYPE_STRING);
      GValue rec_quality_mode = G_VALUE_INIT;
      g_value_init(&rec_quality_mode, G_TYPE_STRING);
  
      GHashTable *out_args = g_hash_table_new (g_str_hash, g_str_equal);
      g_hash_table_insert(out_args, "PlayMode", &play_mode);
      g_hash_table_insert(out_args, "RecQualityMode", &rec_quality_mode);
  
      if (!gupnp_service_proxy_action_get_result_hash (action,
                                                       out_args,
                                                       &error)) {
               g_print ("Getting results failed: %s", error->message);
               g_clear_error (&error);
               return;
      }
  
      g_value_unset (&play_mode);
      g_value_unset (&rec_quality_mode);
  
      g_hash_table_unref (out_args);
  }
  Copy

  Parameters

  • out_hash: { [key: string]: GObject.Value }

    A GLib.HashTable of out parameter name and initialised GObject.Value pairs

  Returns [boolean, { [key: string]: GObject.Value }]

  true on success.

  Since

  1.2.0

  Throws

  GLib.Error

Since 1.2.0get_result_list

• get_result_list(
      out_names: string[],
      out_types: GType<unknown>[],
  ): [boolean, unknown[]]

  A variant of gupnp_service_proxy_action_get_result() that takes lists of out-parameter names, types and place-holders for values.

  The returned list in out_values must be freed using g_list_free and each element in it using g_value_unset and g_free.

  void on_action_finished(GObject *object, GAsyncResult *res, gpointer user_data)
  {
      GUPnPServiceProxyAction *action;
      GError *error;
  
      action = gupnp_service_proxy_call_action_finish (GUPNP_SERVICE_PROXY (object),
                                                       res,
                                                       &error);
  
      if (error != NULL) {
               g_print ("Call failed: %s", error->message);
               g_clear_error (&error);
               return;
      }
  
      GList *out_args = NULL;
      out_args = g_list_append (out_args, "PlayMode");
      out_args = g_list_append (out_args, "RecQualityMode");
      GList *out_types = NULL;
      out_types = g_list_append (out_types, GSIZE_TO_POINTER (G_TYPE_STRING));
      out_types = g_list_append (out_types, GSIZE_TO_POINTER (G_TYPE_STRING));
      GList *out_values = NULL;
  
      if (!gupnp_service_proxy_action_get_result_list (action,
                                                       out_args,
                                                       out_types,
                                                       &out_values,
                                                       &error)) {
               g_print ("Getting results failed: %s", error->message);
               g_clear_error (&error);
               return;
      }
  
      GList *iter = out_values;
      while (iter != NULL) {
          GValue *value = iter->data;
          g_print ("Result: %s\n", g_value_get_string (value));
          g_value_unset (value);
          g_free (value);
          iter = g_list_remove_link (iter, iter);
      }
      g_list_free (out_values);
  }
  Copy

  Parameters

  • out_names: string[]

    GLib.List of 'out' parameter names (as strings)

  • out_types: GType<unknown>[]

    GLib.List of types (as GObject.GType) that line up with out_names

  Returns [boolean, unknown[]]

  true on success.

  Since

  1.2.0

  Throws

  GLib.Error

Since 1.6.6iterate

• iterate(): GUPnP.ServiceProxyActionIter

  Iterate over the out arguments of a finished action

  Returns GUPnP.ServiceProxyActionIter

  A newly created GUPnPServiceProxyActionIterator, or null on error

  Since

  1.6.6

  Throws

  GLib.Error

Since 1.2.0ref

• ref(): ServiceProxyAction

  Increases reference count of action

  Returns ServiceProxyAction

  action with an increased reference count

  Since

  1.2.0

Since 1.4.0set

• set(key: string, value: any): boolean

  Update the value of key to value.

  key needs to already exist in action.

  Parameters

  • key: string

    the name of the value to modify

  • value: any

    the new value of key

  Returns boolean

  true if successfully modified, false otherwise

  Since

  1.4.0

  Throws

  GLib.Error

Since 1.2.0unref

• unref(): void

  Decreases reference count of action. If reference count drops to 0, the action and its contents will be freed.

  Returns void

  Since

  1.2.0

Staticnew_from_list

• new_from_list(
      action: string,
      in_names: string[],
      in_values: any[],
  ): ServiceProxyAction

  Parameters

  • action: string
  • in_names: string[]
  • in_values: any[]

  Returns ServiceProxyAction

Staticnew_plain

• new_plain(action: string): ServiceProxyAction

  Parameters

  • action: string

  Returns ServiceProxyAction