Mediastreamer2 VoIP ძრავის შესწავლა. ნაწილი 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