/* * Copyright (C) 2018,2021 Purism SPC * * This file is part of Calls. * * Calls is free software: you can redistribute it and/or modify it * under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * Calls is distributed in the hope that it will be useful, but * WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * General Public License for more details. * * You should have received a copy of the GNU General Public License * along with Calls. If not, see . * * Author: Bob Ham * * SPDX-License-Identifier: GPL-3.0-or-later * */ #include "calls-provider.h" #include "calls-origin.h" #include "calls-message-source.h" #include "util.h" #include /** * SECTION:calls-provider * @short_description: An abstraction of call providers, such as * oFono, Telepathy or some SIP library. * @Title: CallsProvider * * The #CallsProvider abstract class is the root of the class 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. */ G_DEFINE_ABSTRACT_TYPE (CallsProvider, calls_provider, G_TYPE_OBJECT) enum { PROP_0, PROP_STATUS, PROP_LAST_PROP, }; static GParamSpec *props[PROP_LAST_PROP]; static void calls_provider_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec) { CallsProvider *self = CALLS_PROVIDER (object); switch (prop_id) { case PROP_STATUS: g_value_set_string (value, calls_provider_get_status (self)); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); } } static void calls_provider_class_init (CallsProviderClass *klass) { GObjectClass *object_class = G_OBJECT_CLASS (klass); object_class->get_property = calls_provider_get_property; props[PROP_STATUS] = g_param_spec_string ("status", "Status", "A text string describing the status for display to the user", "", G_PARAM_READABLE | G_PARAM_STATIC_STRINGS); g_object_class_install_properties (object_class, PROP_LAST_PROP, props); } static void calls_provider_init (CallsProvider *self) { } /** * calls_provider_get_name: * @self: a #CallsProvider * * Get the user-presentable name of the provider. * * Returns: A string containing the name. */ const char * calls_provider_get_name (CallsProvider *self) { g_return_val_if_fail (CALLS_IS_PROVIDER (self), NULL); return CALLS_PROVIDER_GET_CLASS (self)->get_name (self); } const char * calls_provider_get_status (CallsProvider *self) { g_return_val_if_fail (CALLS_IS_PROVIDER (self), NULL); return CALLS_PROVIDER_GET_CLASS (self)->get_status (self); } /** * calls_provider_get_origins: * @self: a #CallsProvider * @error: a #GError, or #NULL * * Get the list of #CallsOrigin interfaces offered by this provider. * * Returns: (transfer none): A #GListModel of origins */ GListModel * calls_provider_get_origins (CallsProvider *self) { g_return_val_if_fail (CALLS_IS_PROVIDER (self), NULL); return CALLS_PROVIDER_GET_CLASS (self)->get_origins (self); }