YouTube Sight үчүн Arduino китепканасын түзүү: 7 кадам

2024 Автор: John Day | [email protected]. Акыркы өзгөртүү: 2024-01-30 10:39

Салам баарына, Жакында мен YouTube Sight аттуу кызматты курдум, ал YouTube Analytics APIден жазылуучулардын маалыматын чыгарып, YouTube жыйынтыктарды топтой баштагандан бери сизге жазылуучулардын санын такыраак берет. Анын жардамы менен мен мисалдын эскизин түздүм, бирок мен дагы Arduino китепканасын түзгүм келди, ошондуктан адамдар аны оңой колдоно алышат.

1 -кадам: Китепкана деген эмне?

Китепкана - бул белгилүү бир операцияны башкара турган, маалыматтын бир түрүн иштете турган же конкреттүү аппараттык элемент менен кантип өз ара аракеттенүүнү биле турган код. Алар бизге Arduino чөйрөсүн оңой кеңейтүүгө мүмкүндүк берет жана алардын көбү Arduino IDE менен алдын ала орнотулган.

Мен сыяктуу учурларда, биз Arduinoго жаңы мүмкүнчүлүктөрдү кошкубуз келсе, биз өзүбүздүн китепканаларыбызды түзө алабыз, башка адамдар аларды колдонушу үчүн. Орнотулган китепканалардын баары биздин компьютердеги белгилүү бир папкада жашашат. Менин Windows PC үчүн, китепканалар Documents/Arduino папкасында жашашат. Толук жол колдонуучу атыңыздын негизинде сиз үчүн конкреттүү болот.

2 -кадам: Китепкананын түзүлүшү жана файлдары

Китепканабызды курууну баштоо үчүн, адегенде бул жерде анын аты жазылган папканы түзүшүбүз керек, ошондуктан мен YouTube Sight аттуу папканы түздүм. Китепкананын минималдуу версиясында бизде жок дегенде эки файл болушу керек.

Биринчиси, биздин китепкана камсыз кылган методдордун жана касиеттердин бардык аныктамаларын камтыган "header" деп аталган файл, экинчиси-булактын бардык кодун камтыган баштапкы файл.

Баш файлдар ".h" кеңейтүүсүнө ээ, ал эми баштапкы файл ".cpp" кеңейтүүсүнө ээ жана алар адатта файл аталышы катары китепкананын аталышына ээ. Менин учурда, эки файл "YouTubeSight.h" жана "YouTubeSight.cpp" деп аталат.

Китепкана кодун жазуу процесси бир аз түйшүктүү жана көңүлдү чөгөрүшү мүмкүн, айрыкча, сиз китепкананы биринчи жолу жазып жатканыңызда, бирок көп сыноолор жана каталар менен сиз каалаган натыйжага жете аласыз. Ушундан улам мен сизге эки файлдын даяр коду аркылуу жетектеп, түшүндүрүп берем.

Толук кодду жана китепкананы GitHubдан төмөнкү шилтемеден жүктөп алууга болот:

3 -кадам: Баш файл

Баш файлдын ичинде, башында, бүт файл "ifndef" билдирүүсүнө оролуп, көрсөтүлгөн өзгөрмө аныкталганбы же жокпу текшерет. Бул китепкананы бир эскизге эки жолу жаңылыштык менен киргизсе, ката кетирүүдөн сактайт.

Андан кийин, биз базалык Arduino китепканасын кошушубуз керек жана биз YouTube Sightка суроо жөнөтүү үчүн кандайдыр бир HTTP кардары менен иштей тургандыктан, базалык Кардар китепканасын да кошобуз.

Негизги класстын мазмунун жазууну баштоодон мурун, биз өзгөрткүбүз келбеген статикалык өзгөрмөлөрдү жана орнотууларды аныктообуз керек. Менин учурда, мындай эки өзгөрмөлөр бар. YouTube Sight кызматынын негизги URLи жана маанини канча убакыт окуганыбызды текшерүү үчүн колдонула турган күтүү убактысынын өзгөрмөсү.

Ошондой эле бул бөлүмдө биз бул каналдын статистикасынын структурасы сыяктуу колдонууну каалаган каалаган салттарды аныктай алабыз, аларды биз сактайбыз.

Класстын түзүлүшү эки бөлүккө бөлүнөт. Биринчи бөлүк бардык коомдук функциялардын жана касиеттердин, экинчиси жеке функциялар менен касиеттердин баарынын аныктамасы. Экөөнүн айырмасы, биздин китепкананын акыркы колдонуучулары жеке бөлүмдөн эч нерсени колдоно алышпайт, ал эми алар ачык бөлүктөн кандайдыр бир касиеттерин жана функцияларын түздөн-түз өзгөртө жана колдоно алышат.

Жалпыга ачык бөлүмдө биз класс конструкторун, натыйжаларды сактай турган 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 каналыма жазылыңыз жана Instructablesде мени ээрчиңиз.