Spotify
مضمّن في Macro Deckتحكّم في تشغيل Spotify، وأضف الأغاني إلى المفضلة، وأدر قوائم التشغيل، واعرض ما يُشغَّل على لوحتك.
أداتا مشغّل الموسيقى تشغّلان مقطعًا، إحداهما بنمط غلاف كامل والأخرى بنمط غلاف صغير، وفي رأس كلتيهما اسم Spotify وشعاره
- التشغيل والإيقاف المؤقت والتخطي والانتقال والترتيب العشوائي والتكرار ومستوى الصوت
- تشغيل مقطع أو قائمة تشغيل، أو اختيار واحد عند الضغط على الزر
- إضافة الأغاني إلى المفضلة وإضافة المقطع الحالي إلى قائمة تشغيل
- نقل التشغيل إلى جهاز Spotify آخر
- أداة مشغّل الموسيقى ومتغيرات للمقطع والفنان والتقدم
يربط تكامل Spotify بين Macro Deck وحسابك في Spotify عبر Spotify Web API. يتحكم في التشغيل أينما يعمل Spotify لهذا الحساب: تطبيق سطح المكتب، أو هاتفك، أو مكبر صوت، أو أي جهاز Spotify Connect آخر. لا يلزم أن يعمل Spotify على الحاسوب الذي يعمل عليه Macro Deck.
للاتصال، أنشئ تطبيقًا صغيرًا خاصًا بك في Spotify Developer Dashboard وأدخل معرّف العميل (Client ID) والسر السري للعميل (Client Secret) الخاصين به في Macro Deck. بعد ذلك يفتح Macro Deck صفحة تسجيل الدخول إلى Spotify، وتسمح بالوصول مرة واحدة. يتطلب التحكم في التشغيل عبر Web API اشتراك Spotify Premium؛ وهذه قاعدة من Spotify وليست من Macro Deck.
ما يمكنك فعله
- التشغيل والإيقاف المؤقت والتخطي والانتقال إلى موضع، وتشغيل الترتيب العشوائي أو إيقافه، وضبط وضع التكرار، وتغيير مستوى الصوت.
- بدء مقطع أو قائمة تشغيل محددة. اترك الاختيار فارغًا، وسيطلب منك Macro Deck اختيار واحد عند الضغط على الزر.
- بدء التشغيل على جهاز محدد، أو نقل التشغيل إلى جهاز آخر مع إبقائه قيد التشغيل أو متوقفًا مؤقتًا.
- إضافة المقطع الحالي إلى Liked Songs أو إزالته منها، وإضافته إلى قائمة تشغيل أو إزالته منها.
- عرض ما يُشغَّل في أداة مشغّل الموسيقى، مع الغلاف والتقدم وأزرار التشغيل والتخطي.
- استخدام متغيرات مثل
spotify_current_track_nameفي تسميات الأزرار، وربط منزلق بـspotify_volumeأوspotify_current_position.
بعض الأمثلة على الإعدادات:
- زر Toggle Play/Pause يعرض ما إذا كانت الموسيقى قيد التشغيل أو متوقفة مؤقتًا.
- زر على شكل قلب مع تبديل الأغنية المفضّلة يعرض ما إذا كانت الأغنية الحالية في Liked Songs.
- زر ينقل التشغيل من حاسوبك إلى مكبر الصوت في غرفة المعيشة باستخدام Transfer Playback.
- منزلق مربوط بـ
spotify_volumeيتبع مستوى الصوت ويغيّره أثناء السحب.
كيف يعمل
يسأل Macro Deck خدمة Spotify عن حالة التشغيل كل 3 ثوانٍ تقريبًا أثناء تشغيل الموسيقى، وكل 5 ثوانٍ أثناء الإيقاف المؤقت، وكل 10 ثوانٍ عندما لا يُشغَّل شيء. تظهر التغييرات التي تجريها في تطبيق Spotify خلال هذه المدة. تُجدَّد رموز الوصول في الخلفية، فلا تحتاج إلى تسجيل الدخول مجددًا إلا عندما يلغي Spotify الوصول. عندما يحدّ Spotify من عدد الطلبات أو لا يستجيب، يتوقف Macro Deck مؤقتًا، ويحتفظ بآخر حالة معروفة، ويعرض مشكلة في صفحة Spotify ضمن التكاملات حتى يتمكن من المتابعة. يمكنك ربط حساب Spotify واحد.
ما تحتاج إليه
- حساب Spotify Premium. لا يسمح Spotify إلا لحسابات Premium بالتحكم في التشغيل عبر Web API.
- تطبيق خاص بك في Spotify Developer Dashboard، للحصول على Client ID وClient Secret الخاصين به.
- متصفح ويب على الحاسوب الذي يعمل عليه Macro Deck، لتسجيل الدخول إلى Spotify.
- Spotify مفتوح على جهاز واحد على الأقل، حتى يوجد ما يمكن التحكم فيه.
خطوات الإعداد
الخطوة 1: أنشئ تطبيقًا في Spotify Developer Dashboard
افتح Spotify Developer Dashboard على developer.spotify.com/dashboard، وسجّل الدخول، وأنشئ تطبيقًا جديدًا. أي اسم ووصف يفيان بالغرض.
الخطوة 2: ابدأ الإعداد في Macro Deck
في Macro Deck، انقر التكاملات في الشريط الجانبي ثم انقر Spotify. في علامة التبويب نظرة عامة، انقر إعداد في قسم الإعدادات. يفتح تشغيل المفتاح في أعلى اليسار النافذة نفسها، ويُفعَّل التكامل بعد اكتمال الإعداد. تعرض نافذة الاتصال بـ Spotify قيمة Redirect URI مع زر نسخ.
الخطوة 3: أضف Redirect URI إلى تطبيق Spotify
في إعدادات تطبيق Spotify الخاص بك، أضف Redirect URI الذي يعرضه Macro Deck كما هو تمامًا، ثم احفظ.
الخطوة 4: أدخل Client ID وClient Secret
انسخ معرّف العميل (Client ID) والسر السري للعميل (Client Secret) من تطبيق Spotify الخاص بك والصقهما في الحقلين اللذين يحملان الاسمين نفسيهما في Macro Deck. ثم انقر متابعة.
الخطوة 5: اسمح بالوصول في متصفحك
يفتح Macro Deck صفحة تسجيل الدخول إلى Spotify في متصفحك، وتعرض النافذة في انتظار التفويض…. سجّل الدخول بحساب Premium واسمح بالوصول، ثم عُد إلى Macro Deck. يتابع الإعداد من تلقاء نفسه ويسمّي التهيئة باسم حسابك في Spotify، مثل Spotify (Alex). عندما تعرض النافذة اكتمل الإعداد.، انقر تم.
الخطوة 6: أضف إجراءً إلى زر
في صفحة اللوحة، انقر الزر الذي تريد استخدامه. يجب أن تكون اللوحة غير مقفلة: عندما يعرض الزر في أعلى اليسار قفل، فهي غير مقفلة. يُفتح المحرر مع تحديد ضغطة قصيرة. انقر + إضافة إجراء، واختر Spotify على يمين نافذة إضافة إجراء، ثم اختر إجراءً مثل Toggle Play/Pause. ثم انقر حفظ.
الخطوة 7: اضغط الزر
ابدأ تشغيل شيء في Spotify على أي جهاز، ثم اضغط الزر على لوحتك. يتوقف التشغيل مؤقتًا أو يُستأنف.
الإجراءات18
ضعها على زر أو شغّلها من تدفق.
- Play
- يستأنف التشغيل.
- Pause
- يوقف التشغيل مؤقتًا.
- Toggle Play/Pause
- يبدّل بين التشغيل والإيقاف المؤقت، ويعرض حالة التشغيل على الزر.
- Next Track
- ينتقل إلى المقطع التالي.
- Previous Track
- ينتقل إلى المقطع السابق.
- Refresh State
- يطلب من Spotify حالة التشغيل الحالية فورًا.
- Set Volume
- يضبط مستوى صوت الجهاز الذي يُشغّل، من 0 إلى 100%.
- Volume Up
- يرفع مستوى الصوت بنسبة 10%.
- Volume Down
- يخفض مستوى الصوت بنسبة 10%.
- Seek
- ينتقل إلى موضع في المقطع الحالي، بالثواني.
- Toggle Shuffle
- يشغّل الترتيب العشوائي أو يوقفه أو يبدّله، ويعرض ما إذا كان مفعّلًا.
- Set Repeat Mode
- يضبط التكرار على Off أو Repeat Track أو Repeat Album/Playlist.
- Play Track
- يشغّل مقطعًا تبحث عنه أو تختاره من Liked Songs، أو يطلب منك اختيار واحد عند تشغيل الإجراء.
- Play Playlist
- يشغّل إحدى قوائم التشغيل الخاصة بك أو قائمة تبحث عنها، أو يطلب منك اختيار واحدة عند تشغيل الإجراء.
- Play on Device
- يبدأ التشغيل على جهاز Spotify محدد، أو يطلب منك اختيار جهاز عند تشغيل الإجراء.
- Transfer Playback
- ينقل التشغيل إلى جهاز آخر ويبقيه قيد التشغيل أو متوقفًا مؤقتًا.
- تبديل الأغنية المفضّلة
- يضيف المقطع أو الحلقة الحالية إلى Liked Songs أو يزيله منها، ويعرض ما إذا كان مفضّلًا.
- إضافة أو إزالة من قائمة تشغيل
- يضيف المقطع أو الحلقة الحالية إلى قائمة تشغيل أو يزيله منها، ويعرض ما إذا كان في تلك القائمة.
المشغّلات8
يمكن لزر أو تدفق أن يستجيب لهذه الأحداث.
- تغيّر المقطع
- بدأ تشغيل مقطع آخر، مع عنوانه وفنانه وألبومه (تحت مشغّل الموسيقى).
- بدأ التشغيل
- بدأ التشغيل أو استُؤنف (تحت مشغّل الموسيقى).
- أُوقف التشغيل مؤقتًا
- أُوقف التشغيل مؤقتًا (تحت مشغّل الموسيقى).
- توقّف التشغيل
- توقّف التشغيل (تحت مشغّل الموسيقى).
- تغيّر جهاز التشغيل
- انتقل التشغيل إلى جهاز آخر (تحت مشغّل الموسيقى).
- تغيّر مستوى الصوت
- تغيّر مستوى الصوت، مع القيمة الجديدة والسابقة (تحت مشغّل الموسيقى).
- اتصل المشغّل
- أصبح Spotify قابلًا للوصول (تحت مشغّل الموسيقى).
- انفصل المشغّل
- لم يعد Spotify قابلًا للوصول (تحت مشغّل الموسيقى).
المتغيرات19
اعرض هذه القيم على الأزرار والأدوات، أو استخدمها في الشروط.
spotify_current_track_name- عنوان المقطع الذي يُشغَّل.
spotify_current_artist- فنانو المقطع الحالي، مفصولين بفواصل.
spotify_current_album- ألبوم المقطع الحالي.
spotify_playback_state- حالة التشغيل:
playingأوpausedأوstopped. spotify_is_playing- ما إذا كانت الموسيقى تُشغَّل الآن.
spotify_volume- مستوى الصوت بالنسبة المئوية. يمكنك أيضًا ضبطه، مثلًا بمنزلق.
spotify_track_duration- طول المقطع الحالي بالثواني.
spotify_current_position- المدة التي شُغّلت من المقطع بالثواني. يمكنك أيضًا ضبطه للانتقال.
spotify_progress_percentage- مقدار ما شُغّل من المقطع بالنسبة المئوية.
spotify_album_art_url- عنوان الغلاف الحالي في Macro Deck.
spotify_device_name- اسم الجهاز الذي يُشغّل.
spotify_device_type- نوع الجهاز الذي يُشغّل، مثل حاسوب أو مكبر صوت.
spotify_shuffle_enabled- ما إذا كان الترتيب العشوائي مفعّلًا.
spotify_repeat_mode- وضع التكرار:
offأوtrackأوcontext. spotify_is_connected- ما إذا كان Macro Deck يصل إلى Spotify وتوجد جلسة قابلة للاستخدام.
spotify_current_track_url- رابط Spotify للمقطع الحالي.
spotify_current_track_is_liked- ما إذا كان المقطع الحالي في Liked Songs.
spotify_top_track,spotify_top_artist- المقطع والفنان الأكثر تشغيلًا لديك.
spotify_top_tracks,spotify_top_artists- المقاطع والفنانون الأكثر تشغيلًا لديك كقائمة.
الأدوات1
أضفها إلى لوحتك من منتقي الأدوات.
- مشغّل الموسيقى
- تعرض المقطع والفنانين والغلاف الذي يشغّله Spotify، مع التقدم وأزرار التشغيل والإيقاف المؤقت والتخطي.
الأسئلة الشائعة
لماذا أحتاج إلى Spotify Premium؟
لا يسمح Spotify إلا لحسابات Premium بالتحكم في التشغيل عبر Web API. مع الحساب المجاني، يرفض Spotify الأوامر، ويعرض Macro Deck المشكلة مطلوب Spotify Premium في صفحة Spotify ضمن التكاملات. هذا قيد من Spotify وليس من Macro Deck.
لماذا عليّ إنشاء تطبيق Spotify خاص بي؟
يتواصل Macro Deck مع Spotify باستخدام Client ID وClient Secret لتطبيق تملكه. يحسب Spotify الطلبات لكل تطبيق، فلا تتشارك لوحتك الحد مع مستخدمين آخرين. إنشاء التطبيق مجاني ويستغرق دقيقة في Spotify Developer Dashboard.
هل يجب أن يعمل Spotify على الحاسوب نفسه الذي يعمل عليه Macro Deck؟
لا. يتحكم Macro Deck في حسابك عبر الإنترنت، فيتحكم في Spotify على أي جهاز يُشغّل لهذا الحساب، مثل هاتفك أو مكبر صوت Spotify Connect. باستخدام Play on Device وTransfer Playback تختار الجهاز.
هل يمكنني ربط أكثر من حساب Spotify؟
لا. يدعم التكامل تهيئة واحدة. اختيار إعادة الإعداد يستبدلها بحساب آخر، وتستمر أزرارك وأدواتك في العمل.
يقول Macro Deck إن Spotify يحدّ من طلباته. ماذا أفعل؟
يتوقف Spotify عن الاستجابة عند إرسال طلبات كثيرة جدًا ببيانات اعتماد تطبيقك. يوقف Macro Deck طلباته مؤقتًا ويخبرك عندما يتابع. يحسب الحد كل تطبيق يستخدم Client ID نفسه، لذا يفيد عادةً إغلاق التطبيقات الأخرى التي تستخدمه.
أين تُخزَّن بيانات اعتماد Spotify الخاصة بي؟
يُخزَّن Client Secret والرموز التي يصدرها Spotify مشفّرةً على الحاسوب الذي يعمل عليه Macro Deck، ولا تُرسَل إلا إلى Spotify. لا تُدخل كلمة مرور Spotify في Macro Deck أبدًا؛ إذ تسجّل الدخول في موقع Spotify.
المزيد في الموسيقى والصوت
YouTube Music Desktop App
مضمّن في Macro Deckتحكّم في YouTube Music Desktop App من لوحتك: التشغيل ومستوى الصوت والتقييمات وما يُشغَّل الآن.
WebNowPlaying
مضمّن في Macro Deckتحكّم في الموسيقى ومقاطع الفيديو التي تُشغَّل في متصفحك واعرض ما يُشغَّل، عبر إضافة WebNowPlaying.
Jellyfin
مضمّن في Macro Deckتحكّم في تطبيقات Jellyfin وأجهزة التلفاز من لوحتك، واعرض ما يُشغَّل، واستجب عند بدء التشغيل أو توقفه.
SoundPad
مضمّن في Macro Deckشغّل الأصوات من قائمة SoundPad، وتحكّم في التسجيلات، واعرض الصوت الذي يُشغَّل على لوحتك.
Voicemeeter
مضمّن في Macro Deckتحكّم في الكسب والكتم والتوجيه وأزرار الماكرو في Voicemeeter أو Banana أو Potato من لوحتك.