diff options
Diffstat (limited to 'libmm-glib/mm-call-audio-format.c')
| -rw-r--r-- | libmm-glib/mm-call-audio-format.c | 276 |
1 files changed, 276 insertions, 0 deletions
diff --git a/libmm-glib/mm-call-audio-format.c b/libmm-glib/mm-call-audio-format.c new file mode 100644 index 00000000..a5e5126a --- /dev/null +++ b/libmm-glib/mm-call-audio-format.c @@ -0,0 +1,276 @@ +/* -*- Mode: C; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */ +/* + * This program 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 2 of the License, or + * (at your option) any later version. + * + * This program 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: + * + * Copyright (C) 2017 Red Hat, Inc. + */ + +#include <string.h> + +#include "mm-errors-types.h" +#include "mm-call-audio-format.h" + +/** + * SECTION: mm-call-audio-format + * @title: MMCallAudioFormat + * @short_description: Helper object to handle voice call audio formats. + * + * The #MMCallAudioFormat is an object handling the voice call audio format + * which describes how to send/receive voice call audio from the host. + * + * This object is retrieved with either mm_call_get_audio_format() or + * mm_call_peek_audio_format(). + */ + +G_DEFINE_TYPE (MMCallAudioFormat, mm_call_audio_format, G_TYPE_OBJECT) + +#define PROPERTY_ENCODING "encoding" +#define PROPERTY_RESOLUTION "resolution" +#define PROPERTY_RATE "rate" + +struct _MMCallAudioFormatPrivate { + gchar *encoding; + gchar *resolution; + guint rate; +}; + +/*****************************************************************************/ + +/** + * mm_call_audio_format_get_encoding: + * @self: a #MMCallAudioFormat. + * + * Gets the encoding of the audio format. For example, "pcm" for PCM-encoded + * audio. + * + * Returns: a string with the encoding, or #NULL if unknown. Do not free the returned value, it is owned by @self. + */ +const gchar * +mm_call_audio_format_get_encoding (MMCallAudioFormat *self) +{ + g_return_val_if_fail (MM_IS_CALL_AUDIO_FORMAT (self), NULL); + + return self->priv->encoding; +} + +void +mm_call_audio_format_set_encoding (MMCallAudioFormat *self, + const gchar *encoding) +{ + g_return_if_fail (MM_IS_CALL_AUDIO_FORMAT (self)); + + g_free (self->priv->encoding); + self->priv->encoding = g_strdup (encoding); +} + +/*****************************************************************************/ + +/** + * mm_call_audio_format_get_resolution: + * @self: a #MMCallAudioFormat. + * + * Gets the resolution of the audio format. For example, "s16le" for signed + * 16-bit little-endian audio sampling resolution. + * + * Returns: a string with the resolution, or #NULL if unknown. Do not free the returned value, it is owned by @self. + */ +const gchar * +mm_call_audio_format_get_resolution (MMCallAudioFormat *self) +{ + g_return_val_if_fail (MM_IS_CALL_AUDIO_FORMAT (self), NULL); + + return self->priv->resolution; +} + +void +mm_call_audio_format_set_resolution (MMCallAudioFormat *self, + const gchar *resolution) +{ + g_return_if_fail (MM_IS_CALL_AUDIO_FORMAT (self)); + + g_free (self->priv->resolution); + self->priv->resolution = g_strdup (resolution); +} + +/*****************************************************************************/ + +/** + * mm_call_audio_format_get_rate: + * @self: a #MMCallAudioFormat. + * + * Gets the sampling rate of the audio format. For example, 8000 for an 8000hz + * sampling rate. + * + * Returns: the sampling rate, or 0 if unknown. + */ +guint +mm_call_audio_format_get_rate (MMCallAudioFormat *self) +{ + g_return_val_if_fail (MM_IS_CALL_AUDIO_FORMAT (self), 0); + + return self->priv->rate; +} + +void +mm_call_audio_format_set_rate (MMCallAudioFormat *self, + guint rate) +{ + g_return_if_fail (MM_IS_CALL_AUDIO_FORMAT (self)); + + self->priv->rate = rate; +} + +/*****************************************************************************/ + +GVariant * +mm_call_audio_format_get_dictionary (MMCallAudioFormat *self) +{ + GVariantBuilder builder; + + /* We do allow NULL */ + if (!self) + return NULL; + + g_variant_builder_init (&builder, G_VARIANT_TYPE ("a{sv}")); + if (self) { + if (self->priv->encoding) + g_variant_builder_add (&builder, + "{sv}", + PROPERTY_ENCODING, + g_variant_new_string (self->priv->encoding)); + + if (self->priv->resolution) + g_variant_builder_add (&builder, + "{sv}", + PROPERTY_RESOLUTION, + g_variant_new_string (self->priv->resolution)); + + if (self->priv->rate) + g_variant_builder_add (&builder, + "{sv}", + PROPERTY_RATE, + g_variant_new_uint32 (self->priv->rate)); + } + + return g_variant_builder_end (&builder); +} + +/*****************************************************************************/ + +MMCallAudioFormat * +mm_call_audio_format_new_from_dictionary (GVariant *dictionary, + GError **error) +{ + GVariantIter iter; + gchar *key; + GVariant *value; + MMCallAudioFormat *self; + + self = mm_call_audio_format_new (); + if (!dictionary) + return self; + + if (!g_variant_is_of_type (dictionary, G_VARIANT_TYPE ("a{sv}"))) { + g_set_error (error, + MM_CORE_ERROR, + MM_CORE_ERROR_INVALID_ARGS, + "Cannot create call audio format from dictionary: " + "invalid variant type received"); + g_object_unref (self); + return NULL; + } + + g_variant_iter_init (&iter, dictionary); + while (g_variant_iter_next (&iter, "{sv}", &key, &value)) { + if (g_str_equal (key, PROPERTY_ENCODING)) + mm_call_audio_format_set_encoding ( + self, + g_variant_get_string (value, NULL)); + else if (g_str_equal (key, PROPERTY_RESOLUTION)) + mm_call_audio_format_set_resolution ( + self, + g_variant_get_string (value, NULL)); + else if (g_str_equal (key, PROPERTY_RATE)) + mm_call_audio_format_set_rate ( + self, + g_variant_get_uint32 (value)); + + g_free (key); + g_variant_unref (value); + } + + return self; +} + +/*****************************************************************************/ + +/** + * mm_call_audio_format_dup: + * @orig: a #MMCallAudioFormat + * + * Creates a copy of @orig. + * + * Returns: (transfer full): a newly created #MMCallAudioFormat + */ +MMCallAudioFormat * +mm_call_audio_format_dup (MMCallAudioFormat *orig) +{ + GVariant *dict; + MMCallAudioFormat *copy; + GError *error = NULL; + + g_return_val_if_fail (MM_IS_CALL_AUDIO_FORMAT (orig), NULL); + + dict = mm_call_audio_format_get_dictionary (orig); + copy = mm_call_audio_format_new_from_dictionary (dict, &error); + g_assert_no_error (error); + g_variant_unref (dict); + + return copy; +} + +/*****************************************************************************/ + +MMCallAudioFormat * +mm_call_audio_format_new (void) +{ + return (MM_CALL_AUDIO_FORMAT ( + g_object_new (MM_TYPE_CALL_AUDIO_FORMAT, NULL))); +} + +static void +mm_call_audio_format_init (MMCallAudioFormat *self) +{ + self->priv = G_TYPE_INSTANCE_GET_PRIVATE ((self), + MM_TYPE_CALL_AUDIO_FORMAT, + MMCallAudioFormatPrivate); +} + +static void +finalize (GObject *object) +{ + MMCallAudioFormat *self = MM_CALL_AUDIO_FORMAT (object); + + g_free (self->priv->encoding); + g_free (self->priv->resolution); + + G_OBJECT_CLASS (mm_call_audio_format_parent_class)->finalize (object); +} + +static void +mm_call_audio_format_class_init (MMCallAudioFormatClass *klass) +{ + GObjectClass *object_class = G_OBJECT_CLASS (klass); + + g_type_class_add_private (object_class, sizeof (MMCallAudioFormatPrivate)); + + object_class->finalize = finalize; +} |