# Yandex Smart Home — ViON-ის პლაგინები

წყარო: https://vionvision.tech/ka/plugins/smart-home/yandex

აკავშირებს ViON-ს Yandex-ის ჭკვიან სახლთან და Alice-ის სადგურებთან: ჰაბის სენსორები და რელეები ViON-ის სენსორებად იქცევა, სცენარები ავტომატიზაციებიდან ეშვება, სადგურები შეტყობინებებს წარმოთქვამს, ხოლო ჭკვიანი სახლის კამერები ViON-ში ჩანს.

- პაკეტი: @vionvision/camera-ui-yandex
- ჯგუფი: ჭკვიანი სახლი
- ვერსია: 0.2.4
- საჭიროა: ViON 2.3.4 ან უფრო ახალი
- ლიცენზია: MIT
- https://npm.vionvision.tech/-/web/detail/@vionvision/camera-ui-yandex
- https://github.com/atva0408-create/Vion-plagin/tree/main/camera-ui-yandex#readme

## ტექნიკური აღწერა

აკავშირებს ViON-ს Yandex-ის ჭკვიან სახლთან და Alice-ის სადგურებთან. Yandex სადგურში ჩაშენებული ჰაბის სენსორები და რელეები ViON-ის სენსორებად იქცევა, ჭკვიანი სახლის სცენარები ViON-ის ავტომატიზაციებიდან ეშვება, სადგურები შეტყობინებებს ხმამაღლა კითხულობს, ხოლო ჭკვიანი სახლის კამერები ViON-ში ჩნდება.

## რას აკეთებს

- **სენსორები**: ჭკვიანი სახლის მოძრაობა, კარები და ფანჯრები, გაჟონვა, კვამლი, გაზი, ვიბრაცია, ღილაკები, ტემპერატურა, ტენიანობა, განათებულობა და CO₂ ViON-ის სენსორებად იქცევა. მათ შეუძლიათ კამერებზე ჩაწერისა და ამოცნობის გაშვება და ავტომატიზაციების ამოქმედება
- **მართვა**: ჭკვიანი სახლის რელეები, როზეტები, ჩამრთველები და განათება ViON-ის ჩამრთველებად და განათებად იქცევა, ამიტომ ViON-ის ავტომატიზაციები მათ რთავს და თიშავს
- **კონდიციონერები, ტელევიზორები, ინფრაწითელი პულტები**: ჩართვა-გამორთვის გარდა, კონდიციონერის რეჟიმი, ტემპერატურა და ვენტილატორი, ტელევიზორის ხმა, არხი, შესასვლელი და ხმის გათიშვა, ასევე ინფრაწითელი პულტის დამახსოვრებული ღილაკები მათი ჩამრთველის პარამეტრებშია (ViON-ის Devices გვერდი, More). მხოლოდ ღილაკებისგან შემდგარი პულტი ცალკე ჩამრთველად იქცევა
- **სცენარები**: ჭკვიანი სახლის თითოეული სცენარი ჩამრთველად არის შეთავაზებული. მისი ჩართვა სცენარს უშვებს — ინტერფეისიდან ან ავტომატიზაციიდან
- **მეტყველება სადგურებზე**: Yandex აპლიკაციით შესვლისას თითოეული სადგური შეტყობინებების მიმღები ხდება. თქვენ მიერ ჩართული სადგური შეტყობინებებს ხმამაღლა კითხულობს: „მოძრაობა. ეზოს კამერა“
- **ასისტენტი**: ViON-ის ასისტენტს შეუძლია სადგურზე ფრაზის წარმოთქმა, Alice-ისთვის ბრძანების მიცემა, სცენარის გაშვება და მოწყობილობების მდგომარეობის წაკითხვა
- **კამერები**: ჭკვიანი სახლის კამერები შემოთავაზებულია Cameras განყოფილებაში და პირდაპირ ეთერს აჩვენებს

## შესვლის ორი გზა

პლაგინს შეუძლია ნებისმიერი შესვლის გამოყენება ან ორივესი ერთად.

**ჭკვიანი სახლის ოფიციალური API.** API, რომელსაც Yandex ჭკვიანი სახლის მფლობელებს სთავაზობს. ის კითხულობს მოწყობილობებსა და სცენარებს და აგზავნის ბრძანებებს. Push-ი არ აქვს: პლაგინი მას ინტერვალებით კითხულობს (ნაგულისხმევად 10 წამი). საჭიროა აპლიკაცია Yandex ID-ში უფლებებით iot:view და iot:control:

1. შექმენით აპლიკაცია Yandex ID-ის საიტზე (oauth.yandex.ru): პლატფორმა „ვებ-სერვისები“, უფლებები „ჭკვიანი სახლის მოწყობილობების სიის ნახვა“ და „ჭკვიანი სახლის მოწყობილობების მართვა“
2. შეიყვანეთ მისი **App ID** და **App secret** პლაგინის პარამეტრებში და დააჭირეთ **Sign in with Yandex ID**
3. გახსენით ya.ru/device ტელეფონზე ან კომპიუტერზე, შეიყვანეთ კოდი, რომელსაც ფანჯარა აჩვენებს, შემდეგ დააჭირეთ ღილაკს ფანჯარაში

საიდუმლოს გარეშე ფანჯარა ამის ნაცვლად Yandex ID-ის გვერდს აჩვენებს: იქ დაუშვით წვდომა, დააკოპირეთ ტოკენი და ჩასვით ფანჯარაში. Yandex ID ტოკენს იქ მხოლოდ მაშინ აჩვენებს, თუ აპლიკაციას აქვს Redirect URI oauth.yandex.ru/verification_code (წინ https-ით): ჯერ მიუთითეთ ის აპლიკაციის პარამეტრებში oauth.yandex.ru-ზე.

**Yandex აპლიკაცია (ბმული ან QR კოდი).** პლაგინი ისე შედის, როგორც Yandex-ის აპლიკაციები. ეს შესვლა საჭიროა სადგურებზე მეტყველებისთვის და სენსორების ცვლილებებს მაშინვე ატყობინებს:

1. დააჭირეთ **Sign in with a link or QR code**. იხსნება ფანჯარა ბმულითა და QR კოდით
2. დაადასტურეთ შესვლა ორი გზიდან ერთით:
   - **ბრაუზერში.** დააჭირეთ ღილაკს ბმულის მარჯვნივ: Yandex ახალ ჩანართში იხსნება და შესვლის დადასტურებას გთხოვთ. თუ ამ ბრაუზერში Yandex-ში შესული არ ხართ, ჯერ შესვლას გთხოვთ
   - **ტელეფონზე.** დაასკანერეთ კოდი Yandex აპლიკაციით ტელეფონზე, სადაც Yandex-ში შესული ხართ, და დაადასტურეთ შესვლა აპლიკაციაში. მოსახერხებელია, თუ ბრაუზერში, სადაც ViON არის გახსნილი, Yandex-ში შესული არ ხართ
3. დაბრუნდით ფანჯარაში და დააჭირეთ **Save**. ფანჯარა აჩვენებს ანგარიშს, რომელშიც პლაგინი შევიდა. თუ დადასტურების მოსვლამდე დააჭერთ, ის 20 წამამდე ელოდება და შემდეგ ხელახლა დაჭერას გთხოვთ

დაადასტურეთ იმ Yandex ანგარიშით, რომელსაც თქვენი ჭკვიანი სახლი ეკუთვნის: პლაგინი ხედავს იმ ანგარიშის მოწყობილობებსა და სადგურებს, რომელმაც დაადასტურა. Yandex ამ დადასტურებას ყოველ ჯერზე ითხოვს; მის გარეშე ანგარიშში შესვლა არ სრულდება.

თუ უკვე გაქვთ ანგარიშის x_token, შეგიძლიათ ამის ნაცვლად ჩასვათ ის ველში **x_token**.

## პარამეტრები

- **Read devices through**: Automatic იყენებს ოფიციალურ API-ს, თუ მასში შესვლა შესრულებულია, წინააღმდეგ შემთხვევაში Yandex აპლიკაციას
- **Reading interval**: რამდენად ხშირად იკითხება ოფიციალური API
- **Offer scenarios**: ჩამრთველებად შეთავაზებული სცენარები
- **Speech on the stations**: Local პირდაპირ მიდის სადგურზე სახლის ქსელში და ნებისმიერი სიგრძის ტექსტს კითხულობს. Cloud ანგარიშის სცენარის გავლით მიდის, მუშაობს, სადაც არ უნდა იყოს სადგური, და 100 სიმბოლომდე კითხულობს. Automatic ჯერ Local-ს ცდის
- **Station addresses**: მხოლოდ თუ სადგური ქსელში ვერ მოიძებნა, ფორმით `Kitchen = 192.168.1.20`
- **Say on a station**: მეტყველებას თქვენ მიერ არჩეული ფრაზით ამოწმებს
- **Sign out**: ივიწყებს ორივე შესვლას და იმას, რომელი სადგურები საუბრობს. დამატებული სენსორები და კამერები რჩება

## სენსორების, კამერებისა და სადგურების დამატება

1. შედით, როგორც ზემოთ არის აღწერილი
2. გახსენით **Sensors** ViON-ში: ჭკვიანი სახლის მოწყობილობები დასამატებლად ოთახებთან ერთად არის შეთავაზებული
3. გახსენით **Cameras**: ჭკვიანი სახლის კამერები განყოფილებაშია **Discovered**
4. ViON-ის შეტყობინებების პარამეტრებში, Devices განყოფილებაში, სადგურები ჩნდება, როცა პლაგინი Yandex აპლიკაციით არის შესული. არცერთი არ საუბრობს, სანამ არ ჩართავთ: ჩართეთ Active მათთვის, ვინც უნდა ისაუბროს. ამის გაკეთება მხოლოდ ViON-ის ადმინისტრატორს შეუძლია

## სასარგებლო ინფორმაცია

- იკითხება მხოლოდ თქვენი საკუთარი სახლების მოწყობილობები; თქვენთვის გაზიარებული სახლები — არა
- როცა Yandex შესვლას აღარ იღებს (პაროლი შეიცვალა, წვდომა გაუქმდა), პლაგინი ამის შესახებ ერთხელ წერს ჟურნალში, ივიწყებს ამ შესვლას და ახალს ელოდება. მეორე შესვლა, თუ არის, აგრძელებს მუშაობას
- მოწყობილობა, რომელიც რამდენიმე სენსორს იძლევა, თითოეულს საკუთარი სახელითა და იმით ასახელებს, რასაც აჩვენებს, ინგლისურად: "Hall sensor: Motion". გადაარქვით მათ სახელი ViON-ში, როგორც გსურთ
- მეტყველება და QR კოდით შესვლა Yandex-ის ოფიციალური ინტერფეისი არ არის. Yandex-ის მხარეს ცვლილებამ შეიძლება პლაგინის განახლება მოითხოვოს. ღრუბლით მეტყველებისთვის პლაგინი თითოეული სადგურისთვის ინახავს ერთ სცენარს სახელით "ViON" და სადგურის id-ით; არ წაშალოთ ის
- სადგურის მიკროფონი სხვა სისტემებისთვის ხელმისაწვდომი არ არის: Alice მხოლოდ Yandex-ს უსმენს. ViON-თან ხმით სასაუბროდ გამოიყენეთ ViON-ის უნარი Alice-ისთვის ViON-ის ღრუბელში
- ჭკვიანი სახლის კამერის ვიდეო Yandex-ის ღრუბლიდან მოდის