الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

Xbox-smartglass-core

توفر هذه المكتبة الأساس الأساسي لبروتوكول SmartGlass الذي يتم استخدامه مع وحدة التحكم في ألعاب Xbox One

للحصول على معلومات متعمقة ، تحقق من الوثائق: https://openxbox.org/smartglass-documentation

ملاحظة: منذ 29.02.2020 ، يتم دمج الوحدات التالية في Core: Stump ، مساعدة ، خادم راف

سمات

  • تشغيل / إيقاف تشغيل وحدة التحكم
  • الحصول على معلومات النظام (تشغيل التطبيق/اللعبة/العنوان ، إصدار لوحة القيادة)
  • التحكم في مشغل الوسائط (رؤية معرف المحتوى ، تطبيق المحتوى ، إجراءات التشغيل وما إلى ذلك)
  • بروتوكول الجدعة (تدفق التليفزيون الحية / التحكم في الأشعة تحت الحمراء)
  • بروتوكول تيار العنوان / الدفق (FE Fallout 4 Companion App)
  • الزناد gamedvr عن بعد
  • خادم REST

الأطر الرئيسية المستخدمة

  • Xbox Webapi https://github.com/openxbox/xbox-webapi-python
  • بناء - تحليل ثنائي https://construct.readthedocs.io/
  • التشفير - تشفير السحر https://cryptography.io/en/stable/
  • DPKT - PCAP Parsing https://dpkt.readthedocs.io/en/latest/
  • Fastapi - REST API https://github.com/tiangolo/fastapi
  • Urwid - Tui App https://github.com/urwid/urwid
  • Pydantic - JSON Models https://github.com/samuelcolvin/pydantic

ثَبَّتَ

عبر PIP 

 pip install xbox-smartglass-core

انظر نهاية هذا ReadMe للتعليمات المستهدفة للتطوير.

كيفية استخدام

هناك العديد من أدوات سطر الأوامر للتحقق من :: 

 xbox-cli

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

للمصادقة / الحصول على رموز المصادقة استخدام :: 

 xbox-authenticate

خادم REST

ابدأ خادم الخادم الخادم

معلومات الاستخدام

مثال LocalHost: 

 # Serve on '127.0.0.1:5557'
$ xbox-rest-server
INFO:     Started server process [927195]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://127.0.0.1:5557 (Press CTRL+C to quit)

مثال الشبكة المحلية:

192.168.0.100 هو عنوان IP لجهاز الكمبيوتر الخاص بك الذي يعمل على تشغيل الخادم: 

xbox-rest-server --host 192.168.0.100 -p 1234
INFO:     Started server process [927195]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://192.168.0.100:1234 (Press CTRL+C to quit)

استراحة API

نظرًا لأن الترحيل من Flask Framework إلى Fastapi ، تتوفر وثائق Openapi لطيفة:

http: // {ipaddress}: {port}/docs

المصادقة

إذا كان الخادم الخاص بك يعمل على شيء آخر غير 127.0.0.1:557 أو 127.0.0.1:8080 ، تحتاج إلى تسجيل تطبيق OAuth الخاص بك على Azure AD وتزويد المعلمات المناسبة إلى نقطة تسجيل الدخول إلى خادم REST.

تحقق من: https://github.com/openxbox/xbox-webapi-python/blob/master/readme.md

خدمة الترحيل 4 Fallout

لإعادة توجيه اتصال العنوان من Xbox إلى مضيفك المحلي لاستخدام تطبيقات أو ملحقات Boy Pip التابعة لجهة خارجية 

 xbox-fo4-relay

لقطات الشاشة

هنا يمكنك رؤية SmartGlass Tui (واجهة مستخدم النص):

سير عمل التنمية

هل أنت مستعد للمساهمة؟ إليك كيفية إعداد xbox-smartglass-core-python للتنمية المحلية.

  1. شوكة xbox-smartglass-core-python repo على github.
  2. استنساخ شوكة الخاص بك محليا 
 git clone [email protected]:your_name_here/xbox-smartglass-core-python.git
  1. قم بتثبيت نسختك المحلية في بيئة افتراضية. هذه هي الطريقة التي قمت بإعداد شوكة الخاص بك للتنمية المحلية 
 python -m venv ~/pyvenv/xbox-smartglass
source ~/pyvenv/xbox-smartglass/bin/activate
cd xbox-smartglass-core-python
pip install -e .[dev]
  1. إنشاء فرع للتنمية المحلية :: 
 git checkout -b name-of-your-bugfix-or-feature

  1. قم بإجراء تغييراتك.

  2. قبل الضغط على التغييرات على git ، يرجى التحقق من أنها تعمل بالفعل 

 pytest
  1. ارتكب تغييراتك ودفع فرعك إلى Github :: 
 git commit -m "Your detailed description of your changes."
git push origin name-of-your-bugfix-or-feature
  1. إرسال طلب سحب من خلال موقع GitHub.

سحب إرشادات طلب

قبل إرسال طلب سحب ، تحقق من أنه يلبي هذه الإرشادات:

  1. رمز يتضمن اختبارات الوحدة.
  2. تم تسمية الكود المضافة بشكل صحيح وتوثيق.
  3. على التغييرات الرئيسية ، يتم تحديث ReadMe.
  4. قم بتشغيل الاختبارات / الاصطدام محليًا قبل الضغط على جهاز التحكم عن بُعد.

الاعتمادات

مجد إلى Joelday لمعرفة التواصل المساعد / Titlechannel أولاً! يمكنك العثور على التنفيذ الأصلي هنا: SmartGlass.csharp

تستخدم هذه الحزمة أجزاء من CookieCutter و Audreyr/CookieCutter-pypackage قالب

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل