YouTube -ийн үзэмжээр Arduino номын сан хийх: 7 алхам

2024 Зохиолч: John Day | [email protected]. Хамгийн сүүлд өөрчлөгдсөн: 2024-01-30 11:02

Бүгдээрээ сайн уу, Би саяхан YouTube Analytics API -аас захиалагчдын өгөгдлийг гаргаж авах боломжтой бөгөөд YouTube үр дүнг нэгтгэж эхэлснээс хойш захиалагчдын тоог илүү нарийвчлалтай өгөх боломжтой YouTube Sight нэртэй үйлчилгээ бий болгосон. Үүнтэй холбогдуулан би жишээ ноорог хийлээ, гэхдээ би бас Arduino номын сан хийхийг хүсч байсан бөгөөд ингэснээр хүмүүс үүнийг илүү хялбар ашиглах боломжтой болно.

Алхам 1: Номын сан гэж юу вэ?

Номын сан гэдэг нь тодорхой үйлдлийг гүйцэтгэх, өгөгдлийн төрлийг боловсруулах эсвэл тоног төхөөрөмжийн тодорхой элементтэй хэрхэн харьцах талаар мэдэх кодын хэсэг юм. Тэд бидэнд Arduino орчныг хялбархан өргөтгөх боломжийг олгодог бөгөөд Arduino IDE-ийг урьдчилан суулгасан олон зүйл байдаг.

Надад тохиолдсон тохиолдолд, бид Arduino -д шинэ боломжуудыг нэмэхийг хүсч байгаа бол бусад хүмүүст ашиглахын тулд бид өөрсдийн номын санг бий болгож чадна. Суулгасан бүх номын сан нь манай компьютер дээр тодорхой хавтсанд байрладаг. Миний хувьд Windows PC -ийн хувьд номын сангууд Documents/Arduino хавтсанд амьдардаг. Бүрэн зам нь таны хэрэглэгчийн нэр дээр үндэслэн танд зориулагдсан болно.

Алхам 2: Номын сангийн бүтэц, файлууд

Номын сангаа байгуулж эхлэхийн тулд бид эхлээд энд нэртэй фолдер үүсгэх хэрэгтэй бөгөөд ингэснээр би YouTube Sight нэртэй хавтас үүсгэсэн. Номын сангийн хамгийн бага хувилбар дээр бид дор хаяж хоёр файлтай байх ёстой.

Эхнийх нь манай номын санд өгдөг арга, шинж чанарын бүх тодорхойлолтыг агуулсан "толгой" гэж нэрлэгддэг файл бөгөөд хоёр дахь нь бүх эх кодыг агуулсан эх файл юм.

Толгой файлууд нь ".h" өргөтгөлтэй байхад эх файл нь ".cpp" гэсэн өргөтгөлтэй бөгөөд ихэвчлэн файлын нэр болгон номын сангийн нэрийг агуулдаг. Миний хувьд хоёр файлыг "YouTubeSight.h" ба "YouTubeSight.cpp" гэж нэрлэдэг.

Номын сангийн кодыг бичих үйл явц нь жаахан уйтгартай, сэтгэл дундуур байж магадгүй, ялангуяа та анх удаа номын сан бичиж байгаа боловч маш их туршилт, алдаа хийснээр хүссэн үр дүнд хүрч чадна. Үүний улмаас би танд хоёр файлын дууссан кодыг зааж, тайлбарлах болно.

Бүрэн код болон номын санг дараах холбоос дээр GitHub-аас татаж авах боломжтой:

Алхам 3: Толгой файл

Толгой файл дотор эхэндээ бүх файлыг "ifndef" мэдэгдэлд ороосон бөгөөд заасан хувьсагч тодорхойлогдсон эсэхийг тодорхойлдог. Энэ нь номын санг андуурч нэг ноорог дээр хоёр удаа оруулсан тохиолдолд алдаа гаргахаас урьдчилан сэргийлэх болно.

Дараа нь бид Arduino -ийн үндсэн номын санг оруулах ёстой бөгөөд бид YouTube Sight -д хүсэлт илгээх зарим төрлийн HTTP үйлчлүүлэгчтэй ажиллах тул үндсэн үйлчлүүлэгчийн номын санг оруулах болно.

Үндсэн ангийнхаа агуулгыг бичиж эхлэхээсээ өмнө бид өөрчлөхийг хүсэхгүй байгаа статик хувьсагч, тохиргоог тодорхойлох хэрэгтэй. Миний хувьд ийм хоёр хувьсагч байдаг. YouTube Sight үйлчилгээний үндсэн URL болон утгыг хэр удаан уншсанаа шалгахын тулд ашиглах цаг хугацааны хувьсагч.

Мөн энэ хэсэгт бид үр дүнг хадгалах сувгийн статистикийн бүтэц шиг ашиглахыг хүссэн ямар ч төрлийн төрлийг тодорхойлж болно.

Ангийн бүтцийн тодорхойлолтыг хоёр хэсэгт хуваадаг. Эхний хэсэг нь бүх нийтийн үүрэг, шинж чанарын тодорхойлолт, хоёр дахь хэсэг нь бүх хувийн чиг үүрэг, шинж чанаруудын тодорхойлолт юм. Энэ хоёрын хоорондох ялгаа нь манай номын сангийн эцсийн хэрэглэгчид хувийн хэсгээс юу ч шууд ашиглах боломжгүй бөгөөд олон нийтийн хэсгээс ямар нэгэн шинж чанар, функцийг шууд өөрчилж, ашиглах боломжтой болно.

Нийтийн хэсэгт бид үр дүнг хадгалах сувгийн статистик хувьсагч, өгөгдлийг олж авах функц, дараа нь хүлээгдэж буй үр дүнг авч чадахгүй байгаа тохиолдлуудыг шалгахын тулд ашиглаж болох дибаг хийх шинж чанарыг тодорхойлдог.

Хувийн өмч хөрөнгийн хувьд бид 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 дээрээс намайг дагаарай.