CallsProvider

CallsProvider — An abstraction of call providers, such as oFono, Telepathy or some SIP library.

Functions

Properties

gchar * status Read

Signals

void origin-added Run Last
void origin-removed Run Last

Types and Values

Object Hierarchy

    GInterface
    ╰── CallsProvider

Prerequisites

CallsProvider requires CallsMessageSource and GObject.

Description

The CallsProvider interface is the root of the interface tree that needs to be implemented by a call provider. A CallsProvider provides access to a list of CallsOrigin interfaces, through the calls_provider_get_origins function and the origin-added and origin-removed signals.

Functions

calls_provider_get_name ()

const gchar *
calls_provider_get_name (CallsProvider *self);

Get the user-presentable name of the provider.

Parameters

self

a CallsProvider

 

Returns

A string containing the name.


calls_provider_get_status ()

gchar *
calls_provider_get_status (CallsProvider *self);

calls_provider_get_origins ()

GList *
calls_provider_get_origins (CallsProvider *self);

Get the list of CallsOrigin interfaces offered by this provider.

Parameters

self

a CallsProvider

 

error

a GError, or NULL

 

Returns

A newly-allocated GList of objects implementing CallsOrigin or NULL if there was an error.

Types and Values

CALLS_TYPE_PROVIDER

#define CALLS_TYPE_PROVIDER (calls_provider_get_type ())

struct CallsProviderInterface

struct CallsProviderInterface {
  GTypeInterface parent_iface;

  const gchar * (*get_name) (CallsProvider *self);
  GList * (*get_origins) (CallsProvider *self);
};

CallsProvider

typedef struct _CallsProvider CallsProvider;

Property Details

The “status” property

  “status”                   gchar *

A text string describing the status for display to the user.

Flags: Read

Default value: ""

Signal Details

The “origin-added” signal

void
user_function (CallsProvider *callsprovider,
               CallsOrigin   *arg1,
               gpointer       user_data)

Flags: Run Last


The “origin-removed” signal

void
user_function (CallsProvider *callsprovider,
               CallsOrigin   *arg1,
               gpointer       user_data)

Flags: Run Last