YouTube көру үшін Arduino кітапханасын жасау: 7 қадам

2024 Автор: John Day | [email protected]. Соңғы өзгертілген: 2024-01-30 10:24

Бәріне сәлем, Мен жақында YouTube Analytics API -ден абоненттер туралы деректерді шығара алатын және YouTube нәтижелерді жинақтай бастағаннан бері сізге жазылушылардың дәл санын бере алатын YouTube Sight атты қызметті құрдым. Оның көмегімен мен мысал эскизін құрдым, бірақ мен Arduino кітапханасын жасағым келді, сонда адамдар оны оңай қолдана алады.

1 -қадам: Кітапхана дегеніміз не?

Кітапхана - бұл белгілі бір операцияны өңдей алатын, деректер түрін өңдей алатын немесе белгілі бір аппараттық элементпен өзара әрекеттесуді білетін код бөлігі. Олар бізге Arduino ортасын оңай кеңейтуге мүмкіндік береді және олардың көпшілігі Arduino IDE-мен алдын ала орнатылған.

Мен сияқты, егер біз Arduino -ға жаңа мүмкіндіктер қосқымыз келсе, біз өз кітапханамызды құра аламыз, оны басқа адамдар қолдана алады. Орнатылған барлық кітапханалар біздің компьютердегі белгілі бір қалтада тұрады. Менің жағдайда, Windows ДК үшін кітапханалар Documents/Arduino қалтасында тұрады. Толық жол сіздің пайдаланушы атыңызға байланысты нақты болады.

2 -қадам: Кітапхананың құрылымы мен файлдары

Біздің кітапхананы құруды бастау үшін алдымен осы жерде оның атымен қалта жасау керек, сондықтан мен YouTube Sight деп аталатын қалта жасадым. Кітапхананың ең аз нұсқасында бізде кемінде екі файл болуы керек.

Біріншісі-біздің кітапхана ұсынатын әдістер мен қасиеттердің барлық анықтамаларын қамтитын «тақырып» деп аталатын файл, ал екіншісі-барлық бастапқы кодты қамтитын бастапқы файл.

Тақырып файлдарында «.h» кеңейтімі бар, ал бастапқы файлда «.cpp» кеңейтімі бар және олар әдетте файл атауы ретінде кітапхана атауына ие. Менің жағдайда, бұл екі файл «YouTubeSight.h» және «YouTubeSight.cpp» деп аталады.

Кітапхана кодын жазу процесі, әсіресе кітапхананы бірінші рет жазған кезде, біршама жалықтырып жіберуі мүмкін, бірақ сынақ пен қателіктің көптігімен қалаған нәтижеге қол жеткізуге болады. Осының арқасында мен сізге екі файлдың дайын кодын көрсетіп, түсіндіремін.

Толық код пен кітапхананы GitHub-тан келесі сілтеме бойынша жүктеуге болады:

3 -қадам: тақырыптық файл

Тақырыптық файлдың ішінде, бастапқыда, барлық файл «ifndef» операторына оралады, ол көрсетілген айнымалының анықталғанын немесе анықталмағанын тексереді. Бұл кітапхананы бір эскизге екі рет қателікпен енгізсе, оны пайдаланатындардың қателіктерінің алдын алады.

Әрі қарай, біз Arduino базалық кітапханасын қосуымыз керек, және біз YouTube Sight -қа сұрау жіберу үшін HTTP клиентімен жұмыс істейтін боламыз, сонымен қатар негізгі клиент кітапханасын қосамыз.

Негізгі сыныптың мазмұнын жазуды бастамас бұрын, біз өзгерткіміз келмейтін кез келген статикалық айнымалылар мен параметрлерді анықтауымыз керек. Менің жағдайда, мұндай екі айнымалы бар. YouTube Sight қызметінің негізгі URL мекенжайы және мәнді қанша уақыт оқығанымызды тексеру үшін қолданатын күту уақыты айнымалысы.

Сондай -ақ, бұл бөлімде біз нәтижелерді сақтайтын ChannelStatistics құрылымы сияқты қолданғымыз келетін кез келген реттелетін түрлерді анықтай аламыз.

Сынып құрылымының анықтамасы екі бөлікке бөлінеді. Бірінші бөлім - барлық қоғамдық функциялар мен қасиеттердің анықтамасы, ал екіншісі - барлық жеке функциялар мен қасиеттердің анықтамасы. Екеуінің айырмашылығы мынада, біздің кітапхананың соңғы пайдаланушылары жеке бөлімнен ешнәрсені тікелей пайдалана алмайды, ал олар ашық бөліктегі кез келген қасиеттер мен функцияларды тікелей өзгерте және қолдана алады.

Жалпыға ортақ бөлімде біз нәтижелерді сақтайтын channelStats айнымалы сыныбының конструкторын, деректерді алатын функцияны және күтуге болатын нәтижелерді ала алмайтын жағдайларды тексеру үшін кейінірек қолдануға болатын күйін келтіру сипатын анықтаймыз.

Жеке меншік үшін біз GUID арнасын сақтауға арналған біреуін, біз қолданатын HTTP клиентінің көрсеткішін және YouTube Sight -тан қайтарылған жолды бөлетін функцияны анықтаймыз.

4 -қадам: бастапқы файл

Енді осының барлығын бастапқы файл ішінде нақты іске асыруды қарастырайық.

Біз үшін бірінші қадам - біз жасаған жаңа тақырып файлын қосу, содан кейін кітапхана конструкторын анықтау керек. Онда біз екі айнымалыны жібереміз. GUID біз бұрын анықтаған жеке айнымалыға сақталады және Клиент сілтеме бойынша беріледі, осылайша біз алған дананы шақыра аламыз.

Кітапхананың негізгі getData функциясы алдымен қайтару түрін, содан кейін кітапхана атын және функция атауын көрсету арқылы анықталады. Мен бұл функцияда әрбір жолдың не істейтіні туралы егжей -тегжейлі айтпаймын, бірақ тұтастай алғанда, функция YouTube Sight серверіне қосылуды ашады, статистиканы алу үшін сұрау жібереді, содан кейін қайтарылған деректерді талдау арқылы талдайды. жеке getValue функциясы.

Алынған нәтижелер channelStats айнымалы мәніне қойылады және егер біз нәтижелерді шығарып алсақ немесе алмаса, индикатор қайтарылады, осымен біздің кітапхананың негізгі бөлігі аяқталды.

5 -қадам: Үлгі эскиздерін беру

Әдетте сіз әр кітапханада кітапхананың не істей алатынын және оны қалай жасау керектігін көрсету үшін тез жүктеуге және қолдануға болатын мысалдар келтіресіз. Мұндай мысалдар келтіру үшін бізге кітапхана құрылымын өзгерту қажет, онда енді тақырып пен бастапқы файл «src» қалтасында болады және кітапхана түбірінің астына «мысалдар» деп аталатын жаңа қалта қосылады.

Осы қалтаға салынған кез келген Arduino эскизі сіздің кітапханаңызға үлгі ретінде Arduino IDE -ден беріледі және адамдар оны тез зерттеп, кітапхананың қалай жұмыс істейтінін біле алады.

6 -қадам: Кітапхана менеджеріне жариялау

Кітапхананы пайдалану үшін адамдар сіздің кітапханаңыздың тақырыптық файлын эскизіне енгізуі керек және Arduino IDE оны онымен бірге жасайды. Бірақ бұл үшін олар алдымен оны өз машиналарына орнатуы керек.

Кітапхананы GitHub -дан жүктеу және оны IDE -де ZIP орнатушысы арқылы орнату немесе оны біз жасаған кездегідей кітапханалар қалтасына орналастыру. Сонымен қатар, Arduino IDE -де кітапхананы тікелей IDE -ден іздеуге мүмкіндік беретін Кітапхана менеджері деп аталатын құрал бар.

Кітапхананы оған қосу үшін, алдымен, «library.properties» деп аталатын түбірлік қалтада қосымша файл жасау керек және онда кітапхана атауын, ағымдағы нұсқасын және кітапхана менеджеріне көмектесетін қосымша ақпаратты көрсету қажет. бұл туралы жақсы ақпаратты көрсету үшін.

Файл орнында Arduino GitHub бетінде мәселе туындауы керек, ол сіздің кітапхананы сілтемесі бар индекске қосуды сұрайды және оны Arduino қызметкерлері мақұлдап, қосқаннан кейін кітапхана менеджері нәтижелерде кітапхананы ұсына бастайды. Сонымен қатар, менеджер болашақта GitHub репозиторийіндегі кез келген нұсқалы тегтерді іздейді және өзгерістер болған кезде оны қолданатын адамдарға жаңартуды ұсынады.

7 -қадам: Келесі қадамдар

Осы нұсқаулықтан кейін сіз Arduino кітапханаларының қалай жұмыс істейтінін, оны қалай құруға болатынын жақсы түсінесіз деп үміттенемін, және сіз келесі үлкен идеямен жұмыс жасауға шабыт аласыз деп үміттенемін.

Қосымша сұрақтар мен ұсыныстар үшін түсініктемелерде жазыңыз, менің YouTube каналыма жазылыңыз және нұсқаулықтарда мені осында қадағалаңыз.