არდუინოს ბიბლიოთეკის შექმნა YouTube Sight– ისთვის: 7 ნაბიჯი

2024 ავტორი: John Day | [email protected]. ბოლოს შეცვლილი: 2024-01-30 10:17

Გამარჯობა ყველას, მე ახლახან შევქმენი სერვისი სახელწოდებით YouTube Sight, რომელსაც შეუძლია გამოწეროს აბონენტების მონაცემები YouTube Analytics API– დან და მოგაწოდოთ აბონენტების უფრო ზუსტი რაოდენობა მას შემდეგ რაც YouTube– მა დაიწყო შედეგების გაერთიანება. მასთან ერთად, მე შევქმენი ესკიზის მაგალითი, მაგრამ ასევე მსურდა არდუინოს ბიბლიოთეკის გაკეთება, რათა ხალხმა უფრო ადვილად გამოიყენოს იგი.

ნაბიჯი 1: რა არის ბიბლიოთეკა?

ბიბლიოთეკა არის კოდის ნაჭერი, რომელსაც შეუძლია გაუმკლავდეს კონკრეტულ ოპერაციას, დაამუშაოს მონაცემთა ტიპი ან შეუძლია იცოდეს, თუ როგორ უნდა იმოქმედოს კონკრეტულ ტექნიკურ ელემენტთან. ისინი საშუალებას გვაძლევენ ადვილად გავაფართოვოთ არდუინოს გარემო და ბევრი მათგანია წინასწარ დაინსტალირებული Arduino IDE– ით.

ჩემნაირ შემთხვევებში, როდესაც ჩვენ გვსურს არდუინოს ახალი შესაძლებლობების დამატება, ჩვენ შეგვიძლია შევქმნათ ჩვენი საკუთარი ბიბლიოთეკები, რომ სხვებმა გამოიყენონ ისინი. ყველა დაინსტალირებული ბიბლიოთეკა ცხოვრობს ჩვენს კომპიუტერში არსებულ კონკრეტულ საქაღალდეში. ჩემს შემთხვევაში Windows კომპიუტერისთვის, ბიბლიოთეკები ცხოვრობენ Documents/Arduino საქაღალდის ქვეშ. სრული გზა იქნება კონკრეტული თქვენთვის, თქვენი მომხმარებლის სახელის საფუძველზე.

ნაბიჯი 2: ბიბლიოთეკის სტრუქტურა და ფაილები

ბიბლიოთეკის მშენებლობის დასაწყებად, ჩვენ ჯერ უნდა შევქმნათ საქაღალდე მისი სახელით, ასე რომ მე შევქმენი საქაღალდე სახელწოდებით YouTube Sight. ბიბლიოთეკის მინიმალური ვერსიით, ჩვენ უნდა გვქონდეს მინიმუმ ორი ფაილი.

პირველი არის ეგრეთ წოდებული "სათაურის" ფაილი, რომელიც შეიცავს ჩვენი ბიბლიოთეკის მეთოდებისა და თვისებების ყველა განსაზღვრებას, ხოლო მეორე არის საწყისი ფაილი, რომელიც შეიცავს ყველა წყაროს კოდს.

სათაურის ფაილებს აქვთ გაფართოება ".h", ხოლო წყაროს ფაილს აქვს გაფართოება ".cpp" და მათ ჩვეულებრივ აქვთ ბიბლიოთეკის სახელი, როგორც ფაილის სახელი. ჩემს შემთხვევაში, ორ ფაილს ეწოდება "YouTubeSight.h" და "YouTubeSight.cpp".

ბიბლიოთეკის კოდის წერის პროცესი შეიძლება იყოს ცოტა დამღლელი და იმედგაცრუებული, განსაკუთრებით მაშინ, როდესაც პირველად წერთ ბიბლიოთეკას, მაგრამ ბევრი ცდით და შეცდომით შეგიძლიათ მიაღწიოთ სასურველ შედეგს. ამის გამო მე გაგიძღვები ორი ფაილის მზა კოდს და ავხსნი მას.

სრული კოდი და ბიბლიოთეკა ხელმისაწვდომია GitHub– დან ჩამოსატვირთად შემდეგ ბმულზე:

ნაბიჯი 3: სათაურის ფაილი

სათაურის ფაილის შიგნით, დასაწყისში, მთელი ფაილი შეფუთულია "ifndef" განცხადებაში, რომელიც ამოწმებს განსაზღვრული ცვლადი განსაზღვრულია თუ არა. ეს ხელს შეუშლის შეცდომებს ყველას, ვინც ბიბლიოთეკას იყენებს, თუ შეცდომით ორჯერ შეიტანენ იმავე ესკიზში.

შემდეგი, ჩვენ უნდა შევიტანოთ ძირითადი Arduino ბიბლიოთეკა და ვინაიდან ჩვენ ვიმუშავებთ HTTP კლიენტთან, რომ გამოვაგზავნოთ მოთხოვნა YouTube Sight– ში, ჩვენ ასევე შევიტანთ კლიენტის ძირითად ბიბლიოთეკას.

სანამ დავიწყებთ ჩვენი ძირითადი კლასის შინაარსის წერას, ჩვენ უნდა განვსაზღვროთ ნებისმიერი სტატიკური ცვლადი და პარამეტრი, რომლის შეცვლაც არ გვინდა. ჩემს შემთხვევაში, არსებობს ორი ასეთი ცვლადი. YouTube Sight სერვისის მთავარი URL და დროის ცვლადი, რომელსაც ჩვენ გამოვიყენებთ იმის შესამოწმებლად, რამდენ ხანს ვკითხულობთ მნიშვნელობას.

ასევე ამ განყოფილებაში ჩვენ შეგვიძლია განვსაზღვროთ ნებისმიერი სახის ტიპი, რომლის გამოყენებაც გვსურს ამ არხის მსგავსად სტატისტიკის სტრუქტურა, რომელშიც ჩვენ შევინახავთ შედეგებს.

კლასის სტრუქტურის განმარტება იყოფა ორ ნაწილად. პირველი ნაწილი არის ყველა საჯარო ფუნქციისა და თვისების განსაზღვრა, ხოლო მეორე არის ყველა კერძო ფუნქციისა და თვისების განსაზღვრა. ორივეს შორის განსხვავება ისაა, რომ ჩვენი ბიბლიოთეკის საბოლოო მომხმარებლებს არ ექნებათ შესაძლებლობა გამოიყენონ არაფერი კერძო განყოფილებიდან, ხოლო მათ შეეძლებათ უშუალოდ შეცვალონ და გამოიყენონ საჯარო ნაწილის ნებისმიერი თვისება და ფუნქცია.

საჯარო განყოფილებაში ჩვენ განვსაზღვრავთ კლასის კონსტრუქტორს, channelStats ცვლადს, სადაც შევინახავთ შედეგებს, ფუნქციას, რომელიც მიიღებს მონაცემებს და გამართვის თვისებას, რომელიც შემდგომში შეგვიძლია გამოვიყენოთ იმ შემთხვევების შესამოწმებლად, როდესაც შესაძლოა მოსალოდნელი შედეგები არ მივიღოთ.

კერძო საკუთრებისთვის ჩვენ განვსაზღვრავთ ერთს არხის GUID შესანახად, HTTP კლიენტის მაჩვენებელს, რომელსაც ჩვენ გამოვიყენებთ და ფუნქციას, რომელიც გაყოფს დაბრუნებულ სტრიქონს YouTube Sight– დან.

ნაბიჯი 4: საწყისი ფაილი

ახლა მოდით შევხედოთ ამ ყველაფრის რეალურ განხორციელებას საწყისი ფაილის შიგნით.

ჩვენთვის პირველი ნაბიჯი არის ჩავრთოთ ჩვენი საკუთარი სათაურის ფაილი, რომელიც ჩვენ შევქმენით და შემდეგ ჩვენ უნდა განვსაზღვროთ ბიბლიოთეკის კონსტრუქტორი. მასში ჩვენ გავდივართ ორ ცვლადს. GUID ინახება კერძო ცვლადში, რომელიც ჩვენ ადრე განვსაზღვრეთ და კლიენტი გადადის მითითებით, ასე რომ ჩვენ შეგვიძლია დავრეკოთ იმავე მაგალითზე, რაც მივიღეთ.

ბიბლიოთეკის მთავარი getData ფუნქცია განისაზღვრება შემდეგ დაბრუნების ტიპის მითითებით, შემდეგ ბიბლიოთეკის სახელი და ფუნქციის სახელი. მე არ გავაანალიზებ რას აკეთებს თითოეული ხაზი ამ ფუნქციაში, მაგრამ ზოგადად, ფუნქცია ხსნის კავშირს YouTube Sight სერვერთან, აგზავნის მოთხოვნას სტატისტიკის მისაღებად და შემდეგ აანალიზებს დაბრუნებულ მონაცემებს დახმარებით პირადი getValue ფუნქცია.

მიღებული შედეგები შემდეგ მითითებულია channelStats ცვლადზე და მაჩვენებელი ბრუნდება, თუ ჩვენ შევძელით შედეგების მიღება თუ არა და ამით ჩვენი ბიბლიოთეკის ბირთვი დასრულებულია.

ნაბიჯი 5: ესკიზების მაგალითი

როგორც წესი, თქვენ, ყველა ბიბლიოთეკა იძლევა მაგალითებს, რომლითაც შეგიძლიათ სწრაფად ჩატვირთოთ და გამოიყენოთ იმის საჩვენებლად, თუ რისი გაკეთება შეუძლია ბიბლიოთეკას და როგორ. ასეთი მაგალითების მისაცემად, ჩვენ უნდა შევცვალოთ ბიბლიოთეკის სტრუქტურა, სადაც ახლა სათაური და საწყისი ფაილი იქნება "src" საქაღალდეში და ბიბლიოთეკის ძირში დაემატება ახალი საქაღალდე სახელწოდებით "მაგალითები".

Arduino– ს ნებისმიერი ესკიზი, რომელსაც თქვენ განათავსებთ ამ საქაღალდეში, მოემსახურება Arduino IDE– ს მაგალითს თქვენი ბიბლიოთეკისთვის და ხალხს შეუძლია სწრაფად შეისწავლოს იგი და ისწავლოს ბიბლიოთეკის მუშაობა.

ნაბიჯი 6: გამოქვეყნება ბიბლიოთეკის მენეჯერისთვის

ბიბლიოთეკის გამოსაყენებლად ადამიანებს სჭირდებათ უბრალოდ შეიტანონ თქვენი ბიბლიოთეკის სათაურის ფაილი ესკიზში და Arduino IDE ააშენებს მას ერთად. მაგრამ ამის გასაკეთებლად, მათ ჯერ უნდა დააინსტალირონ თავიანთ აპარატებზე.

საერთო გზა არის ბიბლიოთეკის გადმოტვირთვა GitHub– დან და მისი ინსტალაცია ZIP ინსტალერის საშუალებით IDE– ში, ან უბრალოდ მოთავსება ბიბლიოთეკების საქაღალდეში, როგორც ამას ვაკეთებდით. ამასთან, Arduino IDE ასევე შეიცავს ინსტრუმენტს, სახელწოდებით ბიბლიოთეკის მენეჯერი, რომელიც საშუალებას გაძლევთ მოძებნოთ ბიბლიოთეკა პირდაპირ IDE– დან.

თქვენი ბიბლიოთეკის მასში შესასვლელად, ჩვენ ჯერ უნდა შევქმნათ დამატებითი ფაილი ძირეულ საქაღალდეში სახელწოდებით "libra.properties" და მასში, ჩვენ უნდა მივუთითოთ ბიბლიოთეკის სახელი, მიმდინარე ვერსია და დამატებითი ინფორმაცია, რაც ბიბლიოთეკის მენეჯერს დაეხმარება მასზე უკეთესი ინფორმაციის ჩვენება.

არსებული ფაილით, უნდა შეიქმნას საკითხი Arduino GitHub გვერდზე, რომელიც ითხოვს თქვენი ბიბლიოთეკის ინდექსში შეტანას ბმულით და მას შემდეგ რაც დამტკიცდება და დაემატება არდუინოს თანამშრომლები, ბიბლიოთეკის მენეჯერი დაიწყეთ თქვენი ბიბლიოთეკის შეთავაზება შედეგებში. გარდა ამისა, მენეჯერი მომავალში მოძებნის GitHub რეპოს ვერსიის ნებისმიერ წარწერას და შესთავაზებს განახლებებს იმ ადამიანებს, რომლებიც გამოიყენებენ მას ცვლილებების შემდგომ.

ნაბიჯი 7: შემდეგი ნაბიჯები

ვიმედოვნებ, რომ ამ ინსტრუქციის შემდეგ თქვენ უკეთ გაეცანით როგორ მუშაობს არდუინოს ბიბლიოთეკები, როგორ შეგიძლიათ შექმნათ ერთი და რაც მთავარია, ვიმედოვნებ, რომ თქვენ შთაგონებული იქნებით დაიწყოთ მუშაობა თქვენს მომავალ დიდ იდეაზე.

ნებისმიერი დამატებითი კითხვისა თუ შემოთავაზებისთვის მოგერიდებათ ჩაწერეთ კომენტარებში, გამოიწერეთ ჩემი YouTube არხი და გამომყევით აქ ინსტრუქციებზე.