إن Elgato Key Light وKey Light Air عبارة عن مصابيح فيديو LED مضاءة على الحواف وتحظى بشعبية لدى أجهزة البث المباشر على منصات مثل Twitch. هذه الأضواء عبارة عن أجهزة إنترنت الأشياء ويتم التحكم فيها عادةً باستخدام تطبيق "مركز التحكم" الخاص بشركة Elgato أو من خلال أحد أجهزة Stream Deck (المصنعة أيضًا بواسطة Elgato). لا تدعم أجهزة Key Light بشكل أساسي تكامل الجهات الخارجية، ولكن يمكن التحكم فيها من خلال التفاعل المباشر مع واجهة برمجة التطبيقات المدمجة في الأضواء.
يرسل تطبيق "مركز التحكم" أوامر إلى أجهزة Key Light التي تم ربطها بها عبر HTTP. تم العثور على طلبات واجهة برمجة التطبيقات المحددة في هذا المستند باستخدام Wireshark والإصدار المرجعي 1.1.2 من تطبيق Elgato "Control Center" (Windows 10).
بعد إضافتها إلى الشبكة، من المحتمل أن تتلقى أجهزة Key Light عناوين IP من جهاز التوجيه عبر DHCP. يمكن سحب عناوين IP محددة من خادم DHCP / موجه الشبكة، ولكن يمكن أيضًا الوصول إليها بسهولة في تطبيق "مركز التحكم". للقيام بذلك:
Accessory settings (على شكل شريط التمرير) بجوار اسم الجهازAdvanced . سيتم تقديم عنوان IP ضمن Power On Behavior وإصدار البرنامج الثابتتستمع أجهزة Key Light للأوامر الموجودة على المنفذ 9123 .
ينبغي إرسال جميع الطلبات إلى /elgato .
الحصول على الإعدادات الحالية للجهاز:
curl --location --request GET 'http://192.168.1.61:9123/elgato/lights' --header 'Accept: application/json'
لا تتطلب أجهزة Key Light المصادقة.
تقوم أجهزة Key Light بإرجاع رمزين لحالة HTTP فقط:
200 OK لقد نجح الطلب.400 Bad Request لم يفهم الجهاز الطلب (من المحتمل بسبب بناء جملة غير صحيح)بالإضافة إلى ذلك، فإن أي بيانات يتم إرجاعها بواسطة الجهاز ستكون بتنسيق JSON.
لا يوجد سوى ثلاثة موارد يتم تنفيذها بواسطة Key Light API
lights على معلومات تتعلق بالحالة الحالية لجهاز Key Light والسطوع ودرجة حرارة اللونaccessory-info الملحقات على معلومات تتعلق بمواصفات الأجهزة الفعلية لجهاز Key Lightsettings على معلومات تتعلق بسلوك جهاز Key Light هناك "إجراء" واحد يتم تنفيذه بواسطة Key Light API:
identify إرسال طلب HTTP POST إلى نقطة النهاية هذه إلى وميض الضوء المحدد عدة مرات
