YouTube Music Desktop App
مضمّن في Macro Deckتحكّم في YouTube Music Desktop App من لوحتك: التشغيل ومستوى الصوت والتقييمات وما يُشغَّل الآن.
أداتا مشغّل الموسيقى تشغّلان مقطعًا، إحداهما بنمط غلاف كامل والأخرى بنمط غلاف صغير، وفي رأس كلتيهما اسم YouTube Music Desktop App وشعاره
- التشغيل والإيقاف المؤقت والتخطي والانتقال والترتيب العشوائي والتكرار ومستوى الصوت
- الإعجاب بالمقطع الحالي أو عدم الإعجاب به أو مسح تقييمه
- بدء فيديو أو قائمة تشغيل من رابط أو معرّف
- تحديثات مباشرة عبر Companion Server الخاص بالتطبيق
- أداة مشغّل الموسيقى ومتغيرات للمقطع والفنان والتقدم
يربط تكامل YouTube Music Desktop App بين Macro Deck وYouTube Music Desktop App (YTMDesktop)، تطبيق سطح المكتب لـ YouTube Music. يستخدم Companion Server الخاص بالتطبيق، وهو مدمج في الإصدار 2.0.6 والأحدث. تسمح لـ Macro Deck مرة واحدة في التطبيق، ومن بعدها يتصل تلقائيًا كلما عمل التطبيق.
ما يمكنك فعله
- التشغيل والإيقاف المؤقت والتخطي والانتقال إلى موضع، وتشغيل الترتيب العشوائي أو إيقافه، وضبط وضع التكرار، وتغيير مستوى الصوت.
- كتم صوت التطبيق أو إلغاء كتمه.
- الإعجاب بالمقطع الحالي أو عدم الإعجاب به، أو مسح تقييمه، أو تشغيل الإعجاب أو عدم الإعجاب وإيقافه.
- بدء مقطع من قائمة الانتظار الحالية أو من إحدى قوائم التشغيل الخاصة بك، أو اختيار واحد عند الضغط على الزر.
- بدء فيديو أو قائمة تشغيل محددة من رابط YouTube Music، أو رابط youtu.be، أو معرّف فيديو، أو معرّف قائمة تشغيل.
- عرض ما يُشغَّل في أداة مشغّل الموسيقى، مع الغلاف والتقدم وأزرار التشغيل والتخطي.
- الاستجابة بتدفق عند الإعجاب بمقطع أو عدم الإعجاب به أو مسح تقييمه.
بعض الأمثلة على الإعدادات:
- زر Toggle Play/Pause يعرض ما إذا كانت الموسيقى قيد التشغيل أو متوقفة مؤقتًا.
- زر إعجاب مع تقييم المقطع في وضع تبديل الإعجاب، وتسميته مربوطة بـ
ytmdesktop_like_status. - زر مع تشغيل فيديو أو رابط يبدأ قائمة التركيز الخاصة بك من رابطها في YouTube Music.
- منزلق مربوط بـ
ytmdesktop_volumeيتبع مستوى صوت التطبيق ويغيّره أثناء السحب.
كيف يعمل
يحافظ Macro Deck على اتصال مباشر بـ Companion Server، فتظهر التغييرات التي تجريها في التطبيق على لوحتك فورًا. عندما يُغلق التطبيق، يحاول Macro Deck مجددًا بعد 5 ثوانٍ وينتظر مدة أطول بعد كل محاولة فاشلة، حتى دقيقة واحدة. يعرض المتغير ytmdesktop_is_connected ما إذا كان التطبيق قابلًا للوصول. إذا أُزيل الوصول في التطبيق، تطلب منك المشكلة رفض تطبيق YouTube Music Desktop التفويض في صفحة التكامل تشغيل الإعداد مجددًا. يبحث Macro Deck افتراضيًا عن التطبيق على الحاسوب نفسه. وفي إعدادات متقدمة أثناء الإعداد، يمكنك إدخال عنوان حاسوب آخر. يمكنك إعداد YouTube Music Desktop App واحد.
ما تحتاج إليه
- YouTube Music Desktop App 2.0.6 أو أحدث. الإصدار 1 لا يحتوي على Companion Server.
- تشغيل Companion Server في التطبيق من Settings > Integrations.
- تشغيل Companion Authorization أثناء إعداد Macro Deck.
خطوات الإعداد
الخطوة 1: ثبّت YouTube Music Desktop App
ثبّت YouTube Music Desktop App 2.0.6 أو أحدث وشغّله. تحتوي نافذة الإعداد في Macro Deck على رابط لصفحة إصدارات التطبيق.
الخطوة 2: شغّل Companion Server
في YouTube Music Desktop App، انتقل إلى Settings > Integrations. شغّل Companion Server وCompanion Authorization. يوقف التطبيق التفويض تلقائيًا مجددًا بعد أن تسمح لـ Macro Deck.
الخطوة 3: ابدأ الإعداد في Macro Deck
في Macro Deck، انقر التكاملات في الشريط الجانبي ثم انقر YouTube Music Desktop App. في علامة التبويب نظرة عامة، انقر إعداد في قسم الإعدادات. يفتح تشغيل المفتاح في أعلى اليسار النافذة نفسها، ويُفعَّل التكامل بعد اكتمال الإعداد. لا تحتوي نافذة تفعيل Companion Server على حقول لملئها. إذا كان التطبيق يعمل على حاسوب آخر، فشغّل إعدادات متقدمة وأدخل العنوان الخاص به. اترك المنفذ على
9863. انقر متابعة.الخطوة 4: اسمح لـ Macro Deck في التطبيق
تعرض النافذة الآن السماح لـ Macro Deck مع رمز التفويض. انقر متابعة: تُفتح نافذة موافقة في YouTube Music Desktop App تعرض Macro Deck ورمزًا. تحقق من تطابق الرمزين وانقر Allow خلال 30 ثانية. عندما تعرض النافذة في Macro Deck اكتمل الإعداد.، انقر تم.
الخطوة 5: أضف إجراءً إلى زر
في صفحة اللوحة، انقر الزر الذي تريد استخدامه. يجب أن تكون اللوحة غير مقفلة: عندما يعرض الزر في أعلى اليسار قفل، فهي غير مقفلة. يُفتح المحرر مع تحديد ضغطة قصيرة. انقر + إضافة إجراء، واختر YouTube Music Desktop App على يمين نافذة إضافة إجراء، ثم اختر إجراءً مثل Toggle Play/Pause أو تقييم المقطع. ثم انقر حفظ.
الخطوة 6: اضغط الزر
ابدأ أغنية في YouTube Music Desktop App واضغط الزر على لوحتك. يتوقف التشغيل مؤقتًا أو يُستأنف.
الإجراءات17
ضعها على زر أو شغّلها من تدفق.
- Play
- يستأنف التشغيل.
- Pause
- يوقف التشغيل مؤقتًا.
- Toggle Play/Pause
- يبدّل بين التشغيل والإيقاف المؤقت، ويعرض حالة التشغيل على الزر.
- Next Track
- ينتقل إلى المقطع التالي.
- Previous Track
- ينتقل إلى المقطع السابق.
- Refresh State
- يقرأ حالة التشغيل الحالية فورًا.
- Set Volume
- يضبط مستوى صوت التطبيق، من 0 إلى 100%.
- Volume Up
- يرفع مستوى الصوت بنسبة 10%.
- Volume Down
- يخفض مستوى الصوت بنسبة 10%.
- Seek
- ينتقل إلى موضع في المقطع الحالي، بالثواني.
- Toggle Shuffle
- يشغّل الترتيب العشوائي أو يوقفه أو يبدّله، ويعرض ما إذا كان مفعّلًا.
- Set Repeat Mode
- يضبط التكرار على Off أو Repeat Track أو Repeat Album/Playlist.
- Play Track
- يشغّل مقطعًا من قائمة الانتظار الحالية، أو يطلب منك اختيار واحد عند تشغيل الإجراء.
- Play Playlist
- يشغّل إحدى قوائم التشغيل الخاصة بك، أو يطلب منك اختيار واحدة عند تشغيل الإجراء.
- تقييم المقطع
- يسجّل الإعجاب بالمقطع الحالي أو عدم الإعجاب به أو يمسح تقييمه، أو يشغّل الإعجاب أو عدم الإعجاب ويوقفه.
- كتم
- يكتم صوت التطبيق أو يلغي كتمه أو يبدّله.
- تشغيل فيديو أو رابط
- يبدأ فيديو أو قائمة تشغيل من رابط YouTube Music، أو رابط youtu.be، أو معرّف فيديو، أو معرّف قائمة تشغيل.
المشغّلات8
يمكن لزر أو تدفق أن يستجيب لهذه الأحداث.
- تغيّر التقييم
- سُجّل إعجاب بالمقطع الحالي أو عدم إعجاب به أو مُسح تقييمه، ويمكن قصره على تقييم واحد.
- تغيّر المقطع
- بدأ تشغيل مقطع آخر، مع عنوانه وفنانه وألبومه (تحت مشغّل الموسيقى).
- بدأ التشغيل
- بدأ التشغيل أو استُؤنف (تحت مشغّل الموسيقى).
- أُوقف التشغيل مؤقتًا
- أُوقف التشغيل مؤقتًا (تحت مشغّل الموسيقى).
- توقّف التشغيل
- توقّف التشغيل (تحت مشغّل الموسيقى).
- تغيّر مستوى الصوت
- تغيّر مستوى الصوت، مع القيمة الجديدة والسابقة (تحت مشغّل الموسيقى).
- اتصل المشغّل
- أصبح التطبيق قابلًا للوصول (تحت مشغّل الموسيقى).
- انفصل المشغّل
- لم يعد التطبيق قابلًا للوصول (تحت مشغّل الموسيقى).
المتغيرات21
اعرض هذه القيم على الأزرار والأدوات، أو استخدمها في الشروط.
ytmdesktop_is_connected- ما إذا كان Macro Deck متصلًا بالتطبيق.
ytmdesktop_current_track_name- عنوان المقطع الحالي.
ytmdesktop_current_artist- فنان المقطع الحالي.
ytmdesktop_current_album- ألبوم المقطع الحالي.
ytmdesktop_album_art_url- عنوان الغلاف الحالي في Macro Deck.
ytmdesktop_playback_state- حالة التشغيل:
playingأوpausedأوstopped. ytmdesktop_is_playing- ما إذا كانت الموسيقى تُشغَّل الآن.
ytmdesktop_current_position- المدة التي شُغّلت من المقطع بالثواني. يمكنك أيضًا ضبطه للانتقال.
ytmdesktop_track_duration- طول المقطع الحالي بالثواني.
ytmdesktop_progress_percentage- مقدار ما شُغّل من المقطع بالنسبة المئوية.
ytmdesktop_volume- مستوى صوت التطبيق بالنسبة المئوية. يمكنك أيضًا ضبطه، مثلًا بمنزلق.
ytmdesktop_is_muted- ما إذا كان صوت التطبيق مكتومًا.
ytmdesktop_like_status- تقييم المقطع الحالي:
likeأوdislikeأوindifferent. ytmdesktop_is_liked- ما إذا كان المقطع الحالي مُعجبًا به.
ytmdesktop_shuffle_enabled- ما إذا كان الترتيب العشوائي مفعّلًا.
ytmdesktop_repeat_mode- وضع التكرار:
offأوtrackأوcontext. ytmdesktop_is_live- ما إذا كان العنصر الحالي بثًا مباشرًا.
ytmdesktop_media_type- نوع العنصر الحالي:
audioأوvideoأوuploadedأوpodcast. ytmdesktop_ad_playing- ما إذا كان إعلان يُشغَّل الآن.
ytmdesktop_video_id- معرّف YouTube للمقطع الحالي.
ytmdesktop_device_name- الاسم الذي يظهر كمصدر للتشغيل.
الأدوات1
أضفها إلى لوحتك من منتقي الأدوات.
- مشغّل الموسيقى
- تعرض المقطع والفنان والغلاف الذي يشغّله YouTube Music Desktop App، مع التقدم وأزرار التشغيل والإيقاف المؤقت والتخطي.
الأسئلة الشائعة
هل يعمل مع YouTube Music في المتصفح؟
لا. لا يتواصل هذا التكامل إلا مع YouTube Music Desktop App. لاستخدام YouTube Music في علامة تبويب متصفح، استخدم تكامل WebNowPlaying مع إضافة المتصفح الخاصة به.
هل يستطيع Macro Deck التحكم في التطبيق على حاسوب آخر؟
نعم. أثناء الإعداد، شغّل إعدادات متقدمة وأدخل العنوان الخاص بالحاسوب الذي يعمل عليه YouTube Music Desktop App.
يقول الإعداد إنه تعذّر الوصول إلى التطبيق. ماذا أفعل؟
تحقق من أن YouTube Music Desktop App يعمل، وأن إصداره 2.0.6 أو أحدث، وأن Companion Server مفعّل في Settings > Integrations. ثم انقر متابعة مجددًا.
لماذا يطلب مني الإعداد تشغيل Companion Authorization مرة أخرى؟
لا يقبل التطبيق طلبات التفويض الجديدة إلا ما دام Companion Authorization مفعّلًا، ويوقفه تلقائيًا بعد أن تسمح لتطبيق ما. شغّله، وانقر متابعة، ثم Allow خلال 30 ثانية.
ماذا يحدث عند إغلاق التطبيق؟
يحمل المتغير ytmdesktop_is_connected القيمة false، وتعرض أداة مشغّل الموسيقى أن YouTube Music لا يعمل، وتفشل الإجراءات برسالة تفيد بأن التطبيق غير متصل. عندما تشغّل التطبيق مجددًا، يعيد Macro Deck الاتصال تلقائيًا خلال دقيقة.
المزيد في الموسيقى والصوت
Spotify
مضمّن في Macro Deckتحكّم في تشغيل Spotify، وأضف الأغاني إلى المفضلة، وأدر قوائم التشغيل، واعرض ما يُشغَّل على لوحتك.
WebNowPlaying
مضمّن في Macro Deckتحكّم في الموسيقى ومقاطع الفيديو التي تُشغَّل في متصفحك واعرض ما يُشغَّل، عبر إضافة WebNowPlaying.
Jellyfin
مضمّن في Macro Deckتحكّم في تطبيقات Jellyfin وأجهزة التلفاز من لوحتك، واعرض ما يُشغَّل، واستجب عند بدء التشغيل أو توقفه.
SoundPad
مضمّن في Macro Deckشغّل الأصوات من قائمة SoundPad، وتحكّم في التسجيلات، واعرض الصوت الذي يُشغَّل على لوحتك.
Voicemeeter
مضمّن في Macro Deckتحكّم في الكسب والكتم والتوجيه وأزرار الماكرو في Voicemeeter أو Banana أو Potato من لوحتك.