xbox smartglass core python

Xbox-Smartglass-Core

Эта библиотека предоставляет основную основу для протокола SmartGlass, который используется с игровой консоли Xbox One

Для получения подробной информации, ознакомьтесь с документацией: https://openxbox.org/smartglass-documentation

Примечание. Поскольку 29.02.2020 Следующие модули интегрированы в Core: пень, вспомогательный, REST-SERVER Примечание: Nano Module все еще предлагается отдельно

Функции

• Включение / выключение питания
• Получить системную информацию (запуск приложения/игра/заголовок, версия Dashboard)
• Управление медиаплеерным игроком (видение идентификатора контента, приложение контента, действия воспроизведения и т. Д.)
• Протокол пня (трансляция в прямом эфире / IR Control)
• Протокол заголовка / вспомогательного потока (FE Fallout 4 Companion App)
• Триггер Gamedvr удаленно
• Сервер отдыха

Основные рамки используются

• Xbox webapi https://github.com/openxbox/xbox-webapi-python
• Construct - двоичный анализ https://construct.readthedocs.io/
• Криптография - криптография магия https://cryptography.io/en/stable/
• DPKT - PCAP SACERSING https://dpkt.readthedocs.io/en/latest/
• FASTAPI - REST API https://github.com/tiangolo/FastApi
• Urwid - приложение TUI https://github.com/urwid/urwid
• Pydantic - json models https://github.com/samuelcolvin/pydantic

Установить

Через пип

 pip install xbox-smartglass-core

Смотрите конец этого Readme для нацеленных на разработку инструкций.

Как использовать

Есть несколько утилит командной строки, чтобы проверить ::

 xbox-cli

Некоторые функциональные возможности, такие как Gamedvr Record, требует аутентификации с вашей учетной записью Microsoft, чтобы подтвердить, что вы имеете право вызвать такое действие.

Для аутентификации / получить использование токенов аутентификации ::

 xbox-authenticate

Сервер отдыха

Запустите сервер Демон

Информация об использовании

Пример 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)

REST API

Поскольку миграция от фламбной рамки в Fastapi, доступна хорошая документация OpenAPI:

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

Аутентификация

Если ваш сервер работает на чем-то еще, чем 127.0.0.1:5557 или 127.0.0.1:8080, вам нужно зарегистрировать свое собственное приложение OAuth на Azure AD и предоставить соответствующие параметры для входа в систему на сервере REST.

Проверьте: https://github.com/openxbox/xbox-webapi-python/blob/master/readme.md

Служба эстафеты Fallout 4

Чтобы перестать заголовок от Xbox на местный хост, чтобы использовать сторонние приложения Fallout 4 Pip Boy или расширения

 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

3. Установите локальную копию в виртуальную среду. Вот как вы настроили свою вилку для местного развития

 python -m venv ~/pyvenv/xbox-smartglass
source ~/pyvenv/xbox-smartglass/bin/activate
cd xbox-smartglass-core-python
pip install -e .[dev]

5. Создайте филиал для местного развития ::

 git checkout -b name-of-your-bugfix-or-feature

6. Внесите свои изменения.

7. Прежде чем продвигать изменения в GIT, убедитесь, что они действительно работают

 pytest

8. Сделайте свои изменения и подтолкните вашу ветвь на GitHub ::

 git commit -m "Your detailed description of your changes."
git push origin name-of-your-bugfix-or-feature

9. Отправьте запрос на привлечение через веб -сайт GitHub.

Получить рекомендации по запросу

Прежде чем отправить запрос на привлечение, убедитесь, что он соответствует этим рекомендациям:

1. Код включает в себя модульные тесты.
2. Добавленный код правильно назван и задокументирован.
3. При основных изменениях Readme обновляется.
4. Запустите тесты / сжигание локально, прежде чем настаивать на удаленном.

Кредиты

Слава от Joelday за то, что сначала выяснил общение вспомогательного потока / titleChannel! Вы можете найти оригинальную реализацию здесь: smartglass.csharp

В этом пакете используются части CookieCutter и шаблон проекта Audreyr/CookieCutter-Pypackage