Проучване на VoIP двигателя на Mediastreamer2. част 2

Материалът на статията е взет от моя дзен канал.

Създаване на тон генератор

В предишния Статия Инсталирахме медийната библиотека за стриймър, инструменти за разработка и тествахме тяхната функционалност, като изградихме пробно приложение.

Днес ще създадем приложение, което може да генерира тонален сигнал на звукова карта. За да разрешим този проблем, трябва да свържем филтрите към веригата на звуковия генератор, показана по-долу:

Четем диаграмата отляво надясно, това е посоката, в която се движи нашият поток от данни. За това подсказват и стрелките. Правоъгълниците показват филтри, които обработват блокове от данни и извеждат резултата. Вътре в правоъгълника е посочена неговата роля и типът на филтъра е посочен с главни букви точно отдолу. Стрелките, свързващи правоъгълниците, са опашки от данни, през които блокове от данни се доставят от филтър към филтър. Като цяло един филтър може да има много входове и изходи.

Всичко започва с източника на часовник, който задава темпото, с което се изчисляват данните във филтрите. Според своя тактов цикъл всеки филтър обработва всички блокове данни, които са на неговия вход. И поставя блокове с резултата в опашката. Първо филтърът, който е най-близо до източника на часовник, извършва изчисления, след това филтрите, свързани към неговите изходи (може да има много изходи) и т.н. След като последният филтър във веригата завърши обработката, изпълнението спира, докато пристигне нов часовник. Ударите по подразбиране следват интервал от 10 милисекунди.

Да се ​​върнем към нашата диаграма. Тактовите цикли пристигат на входа на източника на мълчание; това е филтър, който е зает с генерирането на блок от данни, съдържащ нули на своя изход за всеки тактов цикъл. Ако разглеждаме този блок като блок от звукови проби, тогава това не е нищо повече от тишина. На пръв поглед изглежда странно да се генерират блокове от данни с мълчание - в крайна сметка не може да се чуе, но тези блокове са необходими за работата на генератора на звуков сигнал. Генераторът използва тези блокове като празен лист хартия, записвайки звукови проби в тях. В нормалното си състояние генераторът е изключен и просто препраща входни блокове към изхода. Така блоковете на мълчанието преминават непроменени през цялата верига отляво надясно, завършвайки в звуковата карта. Което безшумно взема блокове от опашката, свързана с неговия вход.

Но всичко се променя, ако генераторът получи команда за възпроизвеждане на звук, той започва да генерира звукови проби и ги заменя с проби във входните блокове и поставя променените блокове на изхода. Звуковата карта започва да възпроизвежда звук. По-долу е дадена програма, която изпълнява описаната по-горе работна схема:

/* Файл mstest2.c */
#include <mediastreamer2/msfilter.h>
#include <mediastreamer2/msticker.h>
#include <mediastreamer2/dtmfgen.h>
#include <mediastreamer2/mssndcard.h>
int main()
{
    ms_init();

    /* Создаем экземпляры фильтров. */
    MSFilter  *voidsource = ms_filter_new(MS_VOID_SOURCE_ID);
    MSFilter  *dtmfgen = ms_filter_new(MS_DTMF_GEN_ID);
    MSSndCard *card_playback = ms_snd_card_manager_get_default_card(ms_snd_card_manager_get());
    MSFilter  *snd_card_write = ms_snd_card_create_writer(card_playback);

    /* Создаем тикер. */
    MSTicker *ticker = ms_ticker_new();

    /* Соединяем фильтры в цепочку. */
    ms_filter_link(voidsource, 0, dtmfgen, 0);
    ms_filter_link(dtmfgen, 0, snd_card_write, 0);

   /* Подключаем источник тактов. */
   ms_ticker_attach(ticker, voidsource);

   /* Включаем звуковой генератор. */
   char key='1';
   ms_filter_call_method(dtmfgen, MS_DTMF_GEN_PLAY, (void*)&key);

   /* Даем, время, чтобы все блоки данных были получены звуковой картой.*/
   ms_sleep(2);   
}

След инициализиране на медийния стример се създават три филтъра: voidsource, dtmfgen, snd_card_write. Създава се източник на часовник.

След това трябва да свържете филтрите в съответствие с нашата схема и източникът на часовник трябва да бъде свързан последен, тъй като след това веригата веднага ще започне да работи. Ако свържете източник на часовник към незавършена верига, може да се случи медийният стример да се срине, ако открие поне един филтър във веригата с всички входове или всички изходи, „висящи във въздуха“ (несвързани).

Свързването на филтри се извършва с помощта на функцията

ms_filter_link(src, src_out, dst, dst_in)

където първият аргумент е указател към филтъра източник, вторият аргумент е номерът на изхода на източника (обърнете внимание, че входовете и изходите са номерирани, започвайки от нула). Третият аргумент е указател към филтъра на приемника, четвъртият е входният номер на приемника.

Всички филтри са свързани и източникът на часовник е свързан последен (по-нататък ще го наричаме просто тикер). След което нашата звукова верига започва да работи, но все още нищо не се чува в високоговорителите на компютъра - звуковият генератор е изключен и просто преминава през входните блокове данни с мълчание. За да започнете да генерирате тон, трябва да стартирате филтърния метод на генератора.

Ще генерираме двутонален (DTMF) сигнал, съответстващ на натискане на бутона "1" на телефона. За целта използваме функцията ms_filter_call_method() Извикваме метода MS_DTMF_GEN_PLAY, като му предаваме като аргумент указател към кода, на който трябва да съответства сигналът за възпроизвеждане.

Всичко, което остава, е да компилираме програмата:

$ gcc mstest2.c -o mstest2 `pkg-config mediastreamer --libs --cflags`

И тичай:

$ ./mstest2

След стартиране на програмата от високоговорителя на компютъра ще чуете кратък звуков сигнал, състоящ се от два тона.

Изградихме и пуснахме първата си звукова верига. Видяхме как да създаваме екземпляри на филтри, как да ги свързваме и как да извикваме техните методи. Въпреки че сме доволни от първоначалния си успех, все пак трябва да обърнем внимание на факта, че нашата програма не освобождава разпределената памет, преди да излезе. В следващите Статия ще се научим да чистим след себе си.

Източник: www.habr.com