Kufanya Maktaba ya Arduino kwa Uonaji wa YouTube: Hatua 7

2024 Mwandishi: John Day | [email protected]. Mwisho uliobadilishwa: 2024-01-30 12:50

Halo kila mtu, Hivi majuzi nimeunda huduma inayoitwa YouTube Sight ambayo inaweza kutoa data ya waliojisajili kutoka kwa YouTube Analytics API na kukupa hesabu sahihi zaidi za waliojiandikisha tangu YouTube ilipoanza kujumlisha matokeo. Nayo, nimejenga mchoro wa mfano lakini pia nilitaka kutengeneza maktaba ya Arduino ili watu waweze kuitumia kwa urahisi.

Hatua ya 1: Maktaba ni nini?

Maktaba ni kipande cha nambari ambacho kinaweza kushughulikia operesheni maalum, kuchakata aina ya data au inaweza kujua jinsi ya kuingiliana na kipengee maalum cha vifaa. Wanaturuhusu kupanua mazingira ya Arduino kwa urahisi na kuna mengi ambayo huja-imewekwa kabla na Arduino IDE.

Katika hali kama yangu, ambapo tunataka kuongeza uwezekano mpya kwa Arduino, tunaweza kuunda maktaba zetu wenyewe kwa watu wengine kuzitumia. Maktaba zote zilizowekwa zinaishi kwenye folda maalum kwenye kompyuta yetu. Kwa upande wangu kwa Windows PC, maktaba zinaishi chini ya folda ya Hati / Arduino. Njia kamili itakuwa maalum kwako, kulingana na jina lako la mtumiaji.

Hatua ya 2: Muundo wa Maktaba na Faili

Ili kuanza kujenga maktaba yetu, kwanza tunahitaji kuunda folda hapa na jina lake kwa hivyo nimeunda folda inayoitwa YouTube Sight. Katika toleo la chini kabisa la maktaba, lazima tuwe na faili angalau mbili.

Ya kwanza ni faili inayoitwa "kichwa" ambayo ina ufafanuzi wote wa njia na mali ambazo maktaba yetu hutoa, na ya pili ni faili ya chanzo ambayo itakuwa na nambari yote ya chanzo.

Faili za kichwa zina ugani wa ".h" wakati faili ya chanzo ina ugani wa ".cpp" na kawaida huwa na jina la maktaba kama jina la faili. Kwa upande wangu, faili mbili zinaitwa "YouTubeSight.h" na "YouTubeSight.cpp".

Mchakato wa kuandika nambari ya maktaba inaweza kuwa ya kuchosha na kufadhaisha, haswa wakati unapoandika maktaba kwa mara ya kwanza, lakini kwa jaribio na hitilafu nyingi, unaweza kufikia matokeo unayotaka. Kwa sababu hiyo nitakuongoza kupitia nambari iliyomalizika ya faili mbili na kuelezea.

Nambari kamili na maktaba zinapatikana kwa kupakuliwa kutoka GitHub kwenye kiunga kifuatacho:

Hatua ya 3: Faili ya kichwa

Ndani ya faili ya kichwa, mwanzoni, faili nzima imefungwa ndani ya taarifa ya "ifndef" ambayo huangalia ikiwa tofauti iliyoainishwa imefafanuliwa au la. Hii itazuia makosa kwa mtu yeyote anayetumia maktaba ikiwa ataijumuisha mara mbili kwenye mchoro huo huo kwa makosa.

Ifuatayo, tunahitaji kujumuisha maktaba ya msingi ya Arduino na kwa kuwa tutafanya kazi na mteja wa HTTP wa aina fulani kutuma ombi kwa Uonaji wa YouTube pia tutajumuisha maktaba ya Mteja msingi.

Kabla ya kuanza kuandika yaliyomo katika darasa letu kuu, tunahitaji kufafanua vigeuzi na mipangilio yoyote ambayo hatutaki kurekebishwa. Kwa upande wangu, kuna anuwai mbili. URL kuu ya huduma ya kuona ya YouTube na tofauti ya muda ambao tutatumia kuangalia ni kwa muda gani tunasoma thamani.

Pia katika sehemu hii, tunaweza kufafanua aina yoyote ya kawaida ambayo tunataka kutumia kama muundo huu wa Idara ya Takwimu ambayo tutaokoa matokeo.

Ufafanuzi wa muundo wa darasa umegawanyika katika sehemu mbili. Sehemu ya kwanza ni ufafanuzi wa kazi zote za umma na mali na ya pili ni ufafanuzi wa kazi na mali zote za kibinafsi. Tofauti kati ya zote mbili ni kwamba watumiaji wa mwisho wa maktaba yetu hawataweza kutumia chochote kutoka sehemu ya faragha moja kwa moja wakati wataweza kurekebisha moja kwa moja na kutumia mali na kazi yoyote kutoka kwa sehemu ya umma.

Katika sehemu ya umma, tunafafanua mjenzi wa darasa, kituo cha ChannelStats ambapo tutahifadhi matokeo, kazi ambayo itapata data na mali ya utatuzi ambayo tunaweza kutumia baadaye kuangalia kesi ambazo hatuwezi kupata matokeo yanayotarajiwa.

Kwa mali za kibinafsi, tutafafanua moja ya kuhifadhi kituo cha GUID, kielekezi kwa mteja wa HTTP tutakayotumia na kazi ambayo itagawanya kamba iliyorudishwa kutoka Sight ya YouTube.

Hatua ya 4: Faili Chanzo

Sasa wacha tuangalie utekelezaji halisi wa haya yote ndani ya faili chanzo.

Hatua ya kwanza kwetu ni pamoja na faili yetu ya kichwa ambayo tumeunda tu na kisha tunahitaji kufafanua mjenzi wa maktaba. Ndani yake, tunapita vigezo viwili. GUID imehifadhiwa katika kutofautisha kwa faragha ambayo tulielezea mapema na Mteja hupitishwa kwa rejeleo ili tuweze kupiga mfano ule ule tuliopata.

Kazi kuu ya GetData ya maktaba inafafanuliwa baadaye na kwanza kutaja aina ya kurudi, ikifuatiwa na jina la maktaba na jina la kazi. Sitaenda kwa undani juu ya nini kila laini moja hufanya katika kazi hii, lakini kwa ujumla, kazi hufungua unganisho kwa seva ya Kuona ya YouTube, hutuma ombi kupata takwimu na kisha kuchanganua data iliyorejeshwa kwa msaada wa kazi ya faragha ya GetValue.

Matokeo yaliyopatikana huwekwa kwenye kituo cha ChannelStats na kiashiria kinarudishwa ikiwa tumefanikiwa kupata matokeo au la na kwa kuwa msingi wa maktaba yetu umekamilika.

Hatua ya 5: Kutoa Mifano ya Mfano

Kawaida wewe, kila maktaba hutoa mifano ambayo unaweza kupakia haraka na kuitumia kuonyesha kile maktaba inaweza kufanya na jinsi ya kuifanya. Ili kutoa mifano kama hiyo, tunahitaji kurekebisha muundo wa maktaba ambapo sasa kichwa na faili ya chanzo itakuwa kwenye folda ya "src" na folda mpya itaongezwa chini ya mzizi wa maktaba unaoitwa "mifano".

Mchoro wowote wa Arduino ambao unaweka ndani ya folda hii utatumiwa kutoka IDE ya Arduino kama mfano kwa maktaba yako na watu wanaweza kuichunguza haraka na kujifunza jinsi maktaba inavyofanya kazi.

Hatua ya 6: Kuchapisha kwa Meneja wa Maktaba

Kutumia maktaba, watu watahitaji kujumuisha tu faili ya kichwa cha maktaba yako kwenye mchoro wao na Arduino IDE itaijenga pamoja nayo. Lakini ili kufanya hivyo, kwanza watahitaji kuiweka kwenye mashine zao.

Njia ya kawaida ni kupakua maktaba kutoka GitHub na kuiweka kupitia kisakinishi cha ZIP kwenye IDE au kuiweka tu ndani ya folda ya maktaba kama tulivyofanya wakati tunaiunda. Walakini, IDE ya Arduino pia inajumuisha zana, inayoitwa Meneja wa Maktaba ambayo hukuruhusu kutafuta maktaba moja kwa moja kutoka IDE.

Ili kujumuisha maktaba yako ndani yake, kwanza tunahitaji kuunda faili ya ziada kwenye folda ya mizizi inayoitwa "maktaba.properties" na ndani yake, tunahitaji kutaja jina la maktaba, toleo la sasa na habari zingine za ziada ambazo zitasaidia meneja wa maktaba kuonyesha maelezo bora juu yake.

Pamoja na faili iliyopo, suala linahitajika kuundwa kwenye ukurasa wa Arduino GitHub ambayo inauliza tu maktaba yako ijumuishwe katika faharisi na kiunga chake na mara tu itakapokubaliwa na kuongezwa na wafanyikazi wa Arduino, meneja wa Maktaba anza kutoa maktaba yako katika matokeo. Kwa kuongezea, meneja atatafuta vitambulisho vyovyote vya toleo katika repo ya GitHub katika siku zijazo na atatoa sasisho kwa watu wanaotumia mara tu kuna mabadiliko.

Hatua ya 7: Hatua Zifuatazo

Natumai kuwa baada ya Agizo hili, una uelewa mzuri wa jinsi maktaba za Arduino zinavyofanya kazi, jinsi unavyoweza kuunda moja na muhimu zaidi, natumahi kuwa utapata msukumo wa kuanza kufanyia kazi wazo lako kubwa linalofuata.

Kwa maswali yoyote ya ziada au maoni jisikie huru kuandika maoni, jiunge na kituo changu cha YouTube na unifuate hapa kwenye Maagizo.