node red contrib yandex station management

وصف

باستخدام الوحدة النمطية ، يمكنك التحكم في واجهة برمجة التطبيقات في واجهة برمجة التطبيقات المحلية في أجهزة Yandex:

• محطة Yandex (تم اختبارها)
• محطة Yandex Mini (تم اختبارها)
• Yandex Mini 2 مع شاشة (تم اختبارها)
• محطة Light Yandex (تم اختبارها)
• Yandex Stanzi Max (تم اختباره)
• وحدة Yandex (تم اختبارها)
• وحدة Yandex - 2 (تم اختبارها)
• موسيقى الرابط JBL (لم يتم اختبارها)
• JBL Link Portable (تم اختباره)

العمل ممكن فقط مع الأجهزة التي في نفس الوقت:

• متصل بحساب حساب Yandex
• تقع على نفس الشبكة المحلية مع خادم Node-Red

يتطلب العمل رمزًا من yandex.music. في الوحدة النمطية ، في الوضع التجريبي ، يتم تنفيذ إمكانية الحصول على رمز من طراز تسجيل الدخول (بفضل إرسال هنا). إذا لم ينجح استلام الرمز المميز ، فيجب أن تحاول تشغيل وتعطيل المصادقة ثنائية العوامل في إعدادات Yandex. مصدر. يمكنك التحقق من سلامة استخدام بيانات المحاسبة من خلال النظر في الكود

تم وصف الثانية من المتنافئة من إيصاله في الأسئلة الشائعة

تم وصف الثالث من خيارات الحصول على الرمز المميز هنا

من الممكن العمل مع العديد من الأجهزة (اختبار) والعديد من الحسابات (اختبار).

يتكون من 4 إيماءات تسمح بضبط الأتمتة بمرونة واستخدام إشعارات الصوت:

• في عقدة للاستلام التلقائي للبيانات على حالة العمود
• احصل على عقدة للحصول على بيانات على حالة الجهاز عند الطلب.
• خارج نودا لإرسال أوامر المحطة
• عقدة المحطة لإعدادات إضافية

تثبيت.

يتم تنفيذ التثبيت من خلال قسم Manage Palette في Node-Red أو باستخدام NPM. في الكتالوج باستخدام Node-Red (عادةً ~/.node-red ) لتنفيذ الأمر:

 npm i node-red-contrib-yandex-station-management

الإعداد الأولي.

بعد التثبيت ، لبدء العمل ، إضافة أي عقدة ، أدخل بيانات المحاسبة (الرمز المميز) إلى قسم تسجيل الدخول ، حفظ واضغط على Deploy (إلزامي!). كيفية الحصول على رمز - مكتوب في الأسئلة الشائعة.

بعد مناديل في إعدادات NODA في حقل المحطة ، تتوفر المحطات للتحكم.

إذا لم تظهر المحطة في القائمة ، فيمكنك الانتظار بضع دقائق أو إعادة تشغيل Node-Red.

وصف الاحتمالات وسيناريوهات الاستخدام.

محطة العقدة

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

اتصال بالجهاز

خلع الملابس إلى المحطة. إذا كان من الضروري لسبب ما التأكد من عدم إجراء الاتصال - ضعه في تعطيل.

شبكة

في حالة اليدوية ، يصبح من الممكن الإشارة يدويًا إلى عنوان المحطة والمنفذ للاتصال. يوصى به إذا تم استخدام Docker و HomeasSistant والحالات الأخرى التي لا تعمل فيها على تحديد تفاصيل الشبكة للاتصال.

السيطرة على الأطفال

يتم تنفيذ إمكانية قيود في الوقت المحدد للاستماع إلى الأغاني والراديو والحكايات الخيالية ، بحيث ينام عشاق القصص الليلية الصغار في أقرب وقت ممكن. يتم ضبطه لكل يوم من أيام الأسبوع. إذا كنت لا تكلف مقبس نشط ، فلا تنجح القيود في هذا اليوم. العبارة التي يجب أن نقولها هي عبارة ستقولها أليس بدلاً من الموسيقى :) في نفس الوقت ، المهارات ، التنبيه ، الطقس ، الأخبار وما إلى ذلك في العمل.

عقدة في.

يتم وضعه في بداية التدفق ويرسل البيانات تلقائيًا على الحالة الحالية للعمود بتنسيق "الجبن" و HomeKit.

رسالة الحالة الكاملة (تنسيق "RAW")

يصدر البيانات دون تحويل ، أي في النموذج الذي يتم استلامه من الجهاز. هيكل الرسالة:

    { "aliceState" : " IDLE " ,
    "canStop" : false ,
    "hdmi" :
        { "capable" : true ,
        "present" : false },
    "playerState" :
        { "duration" : 180.91 ,
        "extra" :
            { "coverURI" : " avatars.yandex.net/get-music-content/2383988/de45408f.a.9039208-1/%% " ,
            "stateType" : " music " },
        "hasNext" : true ,
        "hasPause" : false ,
        "hasPlay" : false ,
        "hasPrev" : true ,
        "hasProgressBar" : true ,
        "liveStreamText" : " " ,
        "progress" : 20 ,
        "showPlayer" : true ,
        "subtitle" : " Крематорий " ,
        "title" : " Мусорный ветер " },
        "playing" : false ,
        "timeSinceLastVoiceActivity" : 30454 ,
        "volume" : 0 }

يمكن أن تأتي الرسائل من الجهاز عدة قطع في الثانية ، لذلك يجب أن تفكر في الحاجة إلى وضع عقدة RBE القياسية لتصفية التكرارات وفقًا للمحتوى (payload.playerstate.title) ، اسم المؤدي (payload.playerstate.subtitle)).

HomeKit منسقة

في الداخل ، يمكن ربط تحول التنسيق الصادر تحت HomeKit و Noda مباشرة مع HomeKit-Noda ، ونتيجة لذلك يتم تبسيط التدفق بشكل كبير. يمكن العثور على Yuzkes في نهاية الوثائق.

هناك خيارات لتنسيق HomeKit:

• رسائل فريدة. يتم إرسال الرسائل الفريدة فقط ، دون تكرارات.
• تنسيق HomeKit. اختيار الإخراج للأجهزة المختلفة هو مكبر صوت وتلفزيون ذكي. في أمثلة الاستخدام ، يتم وصف البرامج النصية.

HomeKit مكون - مكبر صوت ذكي:

{ "CurrentMediaState" : 0 , "ConfiguredName" : " International String Trio - Tarantella " }

HomeKit الذي تم تشكيله - التلفزيون:

{ "Active" : 1 }

عند استخدام جهاز التلفزيون ، يصبح من الممكن استخدام "التحكم عن بُعد" على iOS.

عقدة الحصول على.

يتم وضعه في منتصف التدفق ، وبأي رسالة واردة ، يرسل الحالة الأخيرة من الجهاز إلى حمولة. يشبه هيكل الإصدار عقد رسالة الحالة الكاملة في.

نودا خارج.

يتم وضعه في نهاية التدفق ويستخدم لإرسال الرسائل إلى الجهاز. يُسمح باستخدام العديد من الإيماءات لنفس الجهاز ، بينما سيتم إرسال البيانات منها من خلال اتصال واحد مع الجهاز.

أمر اللاعب.

إدارة استنساخ العمود. العقدة تنتظر الحمولة النافعة بخط واحد من الأوامر التالية سيأتي: اللعب ، توقف ، التالي ، السابق ، إلى الأمام (

الأمر الصوتي.

إرسال الفريق ، بدلاً من إخبار عمودها بصوت: "قم بتشغيل الضوء" ، و "تشغيل الموسيقى" ، و "تشغيل قائمة التشغيل الخاصة بي" ، و "افصل في 15 دقيقة" وما إلى ذلك.

TTS.

التكاثر بواسطة صوت العبارات المرسلة - النص إلى seph. ليس له قيود رمز. يمكن تعيين معلمات TTS في الإعدادات ويمكن إعادة تعريف بعضها من خلال رسالة واردة.

• نص. أين وما هو النص الذي يجب التحدث به.
  • من رسالة واردة (msg.payload عن طريق الدفاع)
  • خط محدد بدقة
  • متغير التدفق أو السياق العالمي
  • JSON: اختر رسالة بشكل عشوائي من مجموعة من الأنواع ["واحد" ، "اثنان" ، "ثلاثة"].
• صوت. اختيار الصوت للجيل. يمكن إعادة تعريفها من خلال msg.voice
• تأثير. آثار توليد الصوت. يمكن إعادة تعريفها من خلال msg.ex

هناك عدد من الخيارات:

• مقدار. يتيح لك نطق العبارة مع حجم مجموعة. إذا لم يتم تحديدها ، فسيتم نطق العبارة بمستوى مستوى الصوت الحالي. بعد النطق ، سيعود مستوى الصوت إلى الأصل. يمكن إعادة تعريفها من خلال msg.volume
• يهمس. يتيح لك نطق العبارة مع الهمس .. يطل على msg.whisper
• منع الاستماع. إذا تم تحديده ، فإن العمود بعد التشغيل لا "يستمع" إلى ما سيجيبون عليه. يمكن إعادة تصميمها من خلال msg.prevent_listening
• وقفة بينما TTS. يضع اللاعب توقفًا مؤقتًا لوقت الكلام. لن يستمر التكاثر إلا إذا لعب شيء ما في وقت استلام الفريق. يمكن إعادة تعريفه من خلال msg.pause_music يتم دمج جميع الخيارات مع بعضها البعض.

أضف صوت الحياة والألوان.

ضع الإجهاد

إذا لزم الأمر ، ينبغي ملاحظة حروف العلة الصدمة في الكلمات "+" ، على سبيل المثال:

 остр+ота
м+ука

افصل الكلمات

يمكن تقسيم الكلمات الطويلة إلى كلمات أقصر وتوتر لكل من هذه الكلمات القصيرة ، على سبيل المثال:

MN+WOW PR+ضابط C+EMI PAL+ATINSK

تغيير تهجئة الكلمات

يمكن محاولة كتابة بعض الكلمات عند سماعها:

 «ненастный» — нен+асный
«пожалуйста» — пож+алуста

إضافة توقف مؤقت

للتوقف بين الكلمات ، استخدم SIL Syntax <[number_millisect]>. على سبيل المثال:

 смелость sil <[500]> город+а берёт

يشار إلى كل علامة علامات ترقيم مفصولة بمسافات من خلال توقف 50-100 مللي ثانية.

إضافة أصوات من المكتبة

 <speaker audio="alice-sounds-game-win-1.opus"> У вас получилось!

HomeKit منسقة.

يمسك الإخراج من HomeKit من SmartSpeaker Devices (VCL/OKL) والتلفزيون (VCL/OFF + التحكم عن بعد) لوحدة NRCHB. تم تصميم وظيفة التحقق من hap.context ، مما يمنع الانتفاخ. ينضم مباشرة مع عقدة HomeKit. يشير خيار "الأمر الافتراضي" إلى الأمر الصوتي الذي سيتم تشغيله إذا لم يكن هناك مسار حالي لبدء التشغيل ، ولكن تحتاج إلى تشغيل شيء ما. على سبيل المثال ، "قم بتشغيل موسيقاي" أو "تشغيل أغاني الأطفال".

الأمر الخام.

يتلقى رسالة بتنسيق JSON داخل الحمولة النافعة ونقلها إلى العمود دون معالجة. من الممكن إرسال عدة رسائل في رسالة واحدة عن طريق الحمولة في شكل صفيف. الفرق الشهيرة:

1. الترجيع في ثوان

{
    "command" : " rewind " ,
    "position" : 120
}

2. مواصلة التكاثر

{
    "command" : " play "
}

3. توقف عن سؤال

{
    "command" : " stop "
}

4. المسار السابق

{
    "command" : " prev "
}

5. المسار التالي

{
    "command" : " next "
}

6. تمكين المقاول بالمعرف

{
    "command" : " playMusic " ,
    "id" : " 2 " ,
    "type" : " artist "
}

7. قم بتشغيل المسار للمعرف

{
    "command" : " playMusic " ,
    "id" : " 44731403 " ,
    "type" : " track "
}

8. قم بتشغيل قائمة التشغيل بواسطة ID

{
    "command" : " playMusic " ,
    "id" : " 44731403:1234556 " ,
    "type" : " playlist "
}

9. ضبط مستوى الصوت في النطاق 0-1

{
	"command" : " setVolume " ,
	"volume" : 0.2
}

10. قم بتشغيل الراديو

{
    "command" : " playRadio " ,
    "id" : " detskoe "
}

11. وضع التكرار. "واحد"/"الكل"/"لا شيء"

{
    "command" : " repeat " ,
    "mode" : " One "
}

12. طريقة النتيجة. إنه يعمل عندما يكون هناك مجموعة من المسارات (ألعاب ، ألبوم ، فنان) True/False يتم تشغيله

{
    "command" : " shuffle " ,
    "enable" : true
}

13. تمكين وضع إشارة أليس بالقوة - مشغول ، الاستماع ، "الاستماع"/"مشغول"/"خامد"

{
    "command" : " showAliceVisualState " ,
    "aliceStateName" : " LISTENING " ,
    "recognizedPhrase" : " "
}

14. إرسال "نص" لـ TTS. لم يعد يعمل بعد الآن!

{
	"command" : " sendText " ,
	"text" : " Повторяй за мной 'Текст' "
}

15. أرسل فريق الصوت.

{
	"command" : " sendText " ,
	"text" : " Включи музыку "
}

16. مقاطعة "الاستماع" بعد TTS وليس فقط:

{
    "command" : " serverAction " ,
    "serverActionEventPayload" : {
        "type" : " server_action " ,
        "name" : " on_suggest "
    }
}

17. أرسل "نص" لـ TTS مع المؤثرات الخاصة ( الوضع الخام ):

{
    "command" : " serverAction " ,
    "serverActionEventPayload" : {
        "type" : " server_action " ,
        "name" : " update_form " ,
        "payload" : {
            "form_update" : {
                "name" : " personal_assistant.scenarios.repeat_after_me " ,
                "slots" : [
                    {
                        "type" : " string " ,
                        "name" : " request " ,
                        "value" : " <speaker effect='megaphone'>Ехал Грека через реку <speaker effect='-'>видит Грека в реке рак "
                    }
                ]
            },
            "resubmit" : true
        }
    }
}

• تغيير الصوت

 "value" : " <speaker voice='kostya'>смелость sil <[500]> город+а берёт "

الأصوات المدعومة: جين ، أوكسانا ، أومازي ، وزهر ، وإيرميل ، وليفيتان ، وإيرميلوف ، و سيلايركان ، وكوليا ، وكوستيا ، وناثيا ، ونيك ، وإركانيافاس ، و Zhenya ، و tanya ، و anton_samokhvalov ، و tatyana_abramova ، Zombie ، Smoky ، Alyss ، Nick. (القائمة مأخوذة هنا)

• تكوين توليد الكلام

 "value" : " смелость sil <[500]> город+а берёт "

• الآثار الصوتية

 "value" : " <speaker effect='megaphone'>Ехал Грека через реку <speaker effect='-'>видит Грека в реке рак "

• مكتبة الأصوات

 "value" : " <speaker audio='alice-sounds-game-win-1.opus'>У вас получилось! "

• تحدث في الهمس

 "value" : " <speaker is_whisper= " true"'>Я говорю тихо-тихо!"

• الجمع بين الآثار

 "value" : " <speaker voice='kostya' audio='alice-sounds-game-win-1.opus' effect='megaphone'>добро пожаловать "

18. تحياتي كما في السيارة. سيقول لفترة وجيزة اختناقات الطقس والمرور

{
    "command" : " serverAction " ,
    "serverActionEventPayload" : {
        "type" : " server_action " ,
        "name" : " update_form " ,
        "payload" : {
            "form_update" : {
                "name" : " personal_assistant.automotive.greeting "
            },
            "resubmit" : true
        }
    }
}

19. تشغيل وإيقاف البلوتوث

{
    "command" : " serverAction " ,
    "serverActionEventPayload" : {
        "type" : " server_action " ,
        "name" : " update_form " ,
        "payload" : {
            "form_update" : {
                "name" : " personal_assistant.scenarios.bluetooth_on "
            },
            "resubmit" : true
        }
    }
}

{
    "command" : " serverAction " ,
    "serverActionEventPayload" : {
        "type" : " server_action " ,
        "name" : " update_form " ,
        "payload" : {
            "form_update" : {
                "name" : " personal_assistant.scenarios.bluetooth_off "
            },
            "resubmit" : true
        }
    }
}

توقف عن الاستماع.

الانقطاع القسري لـ "سماع" أليس مع أي رسالة في العقدة. بالمثل 12 فريق من القسم السابق

مثال على استخدام العديد من الأوامر الخام

توقف عن تشغيل الموسيقى وقل نصًا بحجم 0.8

[
    { "command" : " stop " },
    {
        "command" : " serverAction " ,
        "serverActionEventPayload" : {
            "type" : " server_action " ,
            "name" : " on_suggest "
        }
    },
    { "command" : " setVolume " , "volume" : 0.8 },
    {
        "command" : " serverAction " ,
        "serverActionEventPayload" : {
            "type" : " server_action " ,
            "name" : " update_form " ,
            "payload" : {
                "form_update" : {
                    "name" : " personal_assistant.scenarios.repeat_after_me " ,
                    "slots" : [
                        {
                            "type" : " string " ,
                            "name" : " request " ,
                            "value" : " <speaker effect='megaphone'>Ехал Грека через реку <speaker effect='-'>видит Грека в реке рак "
                        }
                    ]
                },
                "resubmit" : true
            }
        }
    }
]

أمثلة على الاستخدام.

إدارة الجهاز.

هناك عدد من الطرق لإدارة تشغيل الموسيقى على الأعمدة.

1. من العقدة الأحمر. في Noda Out في وضع أمر اللاعب ، يجب إرسال أحد الأوامر كخط: Play ، Stop ، التالي ، السابق ، إلى الأمام ، للخلف. أمثلة تذهب مع البرنامج المساعد!
2. من ui-dashboard. أشكر المشاركين في مجتمع Node-Red على sprut.ai على التعلق بالأمثلة. إذا كان المكون الإضافي الذي يحتوي على لوحة معلومات لا يستحق ذلك ، فيجب وضعه. بعد ذلك ، لتسوية المثال من العقدة وعنوان /واجهة المستخدم هناك عناصر تحكم.

هناك خيار آخر من twocolors ، في أمثلة.

يضاف بواسطة تدفق بسيط ويبدو رائعًا)

3. من HomeKit. العقد والحصول على القدرة على إصدار الرسائل بتنسيق HomeKit جاهز. يمكنك إعداد رسالة بشكل مستقل للإرسال إلى HomeKit ، أو يمكنك ببساطة استخدام الإعداد الصحيح داخل GCD. سيكون تثبيت الرسائل unike لـ In-Nodes معقولة حتى لا تملأ HomeKit بنفس الرسائل.

تحتوي قائمة أجهزة NRCHB على مكبر صوت ذكي. من المربع مع تدفق بسيط ، يمكنك التحكم في حالة التكاثر الصوتي ومعرفة اسم المسار. إنه يعمل فقط على iOS 14 أو Macos Big Sur. العناصر الإدارية داخل HomeKit لا تعمل ، لم يتم إحضارها بعد من قبل عقدة HomeKit.

إذا كنت بحاجة إلى العمل على الإصدارات القديمة من iOS/MacOS أو تحتاج إلى التحكم في التكاثر من الأداة القياسية للتحكم عن بُعد من لوحة التحكم ، فيمكنك تجميع التدفق على أساس تلفزيون HomeKit-Nod ، والعقد في التنسيق المقابل والخارج. في الوقت نفسه ، يعرف Out-Noda في Formkit Confer كيفية "فهم" المدخل من SmartSpeaker والتلفزيون وكلاهما معًا. يتم التحقق من الرسائل للسخرية في نودا خارج.

التعليمات.

س: كيف تحصل على Oauth-token؟

ج: كواحد من الخيارات https: //music-yandex-bot.ru

• أدخل تسجيل الدخول وكلمة المرور الخاصة بك
• سيظهر زر "انتقل إلى الروبوت" ، لا تضغط عليه ، ولكن انسخ الرابط
• داخل الرابط ، جميع الحروف cyfras بعد و START = وهناك رمز الرمز المميز

س: كيف تحصل على غطاء المسار؟

ج: يمكنك أخذ رابط إلى غطاء الموسيقى Yandex من رسالة الحالة: payload.playerstra.coveri

في البداية ، أضف https: // وفي النهاية بدلاً من ٪ حجم الغلاف ، على سبيل المثال 600x600. https://avatars.yandex.net/get-music-content/2383988/de45408f.a.9039208-1/600x600

س: كيف تكتشف محطة المحطة؟ قد تكون هناك حاجة لتمييز المحطات إذا لم تكن هناك واحدة.

ج: ملحق Yandex على الهاتف - الأجهزة - إدارة الجهاز - حدد المحطة - معلومات إضافية

س: لماذا لا يتغير اسم المسار في HomeKit فور التبديل؟

ج: هذا أمر طبيعي ، حيث يتم استخدام اسم الجهاز للعرض ، وتنعكس التغييرات في الأسماء في HomeKit ، حيث أن لها أولوية أصغر قبل الحالات والظروف.

س: عناصر الإدارة داخل HomeKit "عالقة" ولا تعمل

ج: إذا تم استخدام نوع جهاز مكبر الصوت الذكي ، فهناك نعم ، فهي لا تعمل هناك ولم أجد كيفية جعلها نشطة. إذا تمكن شخص ما من جعله نشطًا ، فإن إنشاء مشكلة سيساعد الباقي. الآن البديل هو جهاز تلفزيوني وتزامن التحكم عن بُعد إليه. تلقى Appletv. مثال داخل NRCHB

س: بعد بدء تشغيل العقدة ، لا يكون الجهاز/الجهاز مرئيًا.

ج: يحدث هذا إذا لم يتم العثور على الجهاز على الشبكة. يجب أن يكون من المفهوم أن بروتوكول ZeroconF ، الذي يستخدم للبحث ، لا يعطي نتيجة مستقرة. بحث واحد عن 5 نهايات في غياب الأجهزة التي تم العثور عليها. كحل - فقط انتظر بضع دقائق وسيجد البحث الثاني جميع الأشخاص المفقودين من الرادار

س: كيفية إضافة مثال من عقدة؟

ج: في القائمة الحمراء ، يوجد عنصر استيراد ، وفي قسم الأمثلة. داخل المجلد باسم المكون الإضافي ، هناك جميع الأمثلة.

يتم أخذ فرق لإدارة المحطة هنا. شكرا للمؤلف.

إنجليزي

تكامل Node-Red مع أجهزة Yandex من خلال WebSocket:

 - Yandex Station(tested)
- Yandex Mini(tested)
- Yandex Station Max(tested)
- Yandex Module(not tested)
- JBL Link Music(not tested)
- JBL Link Portable(tested)

تثبيت

 Run the following command in your Node-RED user directory - typically `~/.node-red`

npm i node-red-contrib-yandex-station-management

تحتاج إلى رمز الموسيقى Yandex للعمل بشكل خاص.