# Yandex Smart Home — إضافات ViON

المصدر: https://vionvision.tech/ar/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 وتطفئها
- **المكيّفات والتلفزيونات وأجهزة التحكم بالأشعة تحت الحمراء**: إلى جانب التشغيل والإيقاف، توجد في إعدادات المفتاح الخاص بكل منها (صفحة Devices في ViON، ثم More) أوضاعُ المكيّف وحرارته ومروحته، ومستوى صوت التلفزيون وقناته ومدخله وكتم صوته، والأزرار المتعلَّمة في جهاز التحكم بالأشعة تحت الحمراء. وجهاز التحكم المكوّن من أزرار فقط يصبح مفتاحًا مستقلًا
- **السيناريوهات**: يُعرض كل سيناريو في المنزل الذكي بوصفه مفتاحًا. وتشغيله يُطلق السيناريو، من الواجهة أو من عملية أتمتة
- **النطق على المكبّرات**: مع تسجيل الدخول بوصفه تطبيق Yandex يصبح كل مكبّر وجهةً للإشعارات. والمكبّر الذي تفعّله يقرأ الإشعارات بصوت عالٍ: «حركة. كاميرا الفناء»
- **المساعد**: يمكن لمساعد ViON أن ينطق عبارة على مكبّر، ويعطي Alice أمرًا، ويشغّل سيناريو، ويقرأ حالة الأجهزة
- **الكاميرات**: تُعرض كاميرات المنزل الذكي ضمن Cameras وتعرض بثها المباشر

## طريقتان لتسجيل الدخول

يمكن للإضافة استخدام أي من طريقتي تسجيل الدخول، أو الاثنتين معًا.

**الواجهة البرمجية الرسمية للمنزل الذكي.** الواجهة البرمجية التي توفرها Yandex لمالكي المنزل الذكي. تقرأ الأجهزة والسيناريوهات وترسل الأوامر. لا تدعم الإشعارات الفورية: تستطلعها الإضافة على فترات (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 يستخدم الواجهة البرمجية الرسمية عند تسجيل الدخول إليها، وإلا تطبيق Yandex
- **Reading interval**: عدد مرات استطلاع الواجهة البرمجية الرسمية
- **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" مع معرّف المكبّر؛ فلا تحذفه
- ميكروفون المكبّر غير متاح للأنظمة الأخرى: Alice لا تستمع إلا لـ Yandex. وللتحدث مع ViON بالصوت، استخدم مهارة ViON لـ Alice في سحابة ViON
- فيديو كاميرا المنزل الذكي يأتي من سحابة Yandex