xbox smartglass core python

Xbox-smartglass-core

Esta biblioteca proporciona la base central para el protocolo SmartGlass que se utiliza con la consola de juegos Xbox One

Para obtener información en profundidad, consulte la documentación: https://openxbox.org/smartglass-documentation

Nota: Desde 29.02.2020, los siguientes módulos están integrados en el núcleo: tocón, auxiliar, servidor de descanso nota: el módulo nano todavía se ofrece por separado

Características

• Encender / apagar la consola
• Obtenga información del sistema (ejecutando aplicación/juego/título, versión del tablero)
• Control de reproductor multimedia (ver ID de contenido, aplicación de contenido, acciones de reproducción, etc.)
• Protocolo de tocón (transmisión de televisión en vivo / control IR)
• Título / Protocolo de transmisión auxiliar (FE Fallout 4 Aplicación complementaria)
• Disparador de giro de forma remota
• Servidor de descanso

Los principales marcos utilizados

• Xbox webapi https://github.com/openxbox/xbox-webapi-python
• Construcción - análisis binario https://construct.readthedocs.io/
• Criptografía - Criptografía Magic https://cryptography.io/en/stable/
• DPKT - PCAP PARSING https://dpkt.readthedocs.io/en/latest/
• Fastapi - REST API https://github.com/tiangolo/fastapi
• Urwid - TUI Aplicación https://github.com/urwid/urwid
• Pydantic - JSON Models https://github.com/samuelcolvin/pydantic

Instalar

A través de Pip

 pip install xbox-smartglass-core

Consulte el final de este readme para las instrucciones dirigidas por el desarrollo.

Cómo usar

Hay varias utilidades de línea de comandos para ver ::

 xbox-cli

Alguna funcionalidad, como el registro de GamedVR, requiere autenticación con su cuenta de Microsoft para validar que tiene derecho a activar dicha acción.

Para autenticar / obtener tokens de autenticación use ::

 xbox-authenticate

Servidor de descanso

Inicie el demonio del servidor

Información de uso

Ejemplo 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)

Ejemplo de red local:

192.168.0.100 es la dirección IP de su computadora que ejecuta el servidor:

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 REST

Dado que la migración de Flask Framework a Fastapi, hay una buena documentación de Openapi disponible:

http: // {ipaddress}: {puerto}/docs

Autenticación

Si su servidor se ejecuta en algo más que 127.0.0.1:5557 o 127.0.0.1:8080 debe registrar su propia aplicación OAuth en Azure AD y proporcionar parámetros apropiados al punto de inicio de sesión del servidor REST.

Echa un vistazo: https://github.com/openxbox/xbox-webapi-python/blob/master/readme.md

Servicio de relevos de Fallout 4

Para reenviar la comunicación del título de la Xbox a su anfitrión local para usar las aplicaciones o extensiones de terceros Fallout 4 Pip Boy

 xbox-fo4-relay

Capturas de pantalla

Aquí puede ver el SmartGlass TUI (interfaz de usuario de texto):

Flujo de trabajo de desarrollo

¿Listo para contribuir? Aquí le mostramos cómo configurar xbox-smartglass-core-python para el desarrollo local.

1. Bifurca el repositorio xbox-smartglass-core-python en GitHub.
2. Clone tu tenedor localmente

 git clone [email protected]:your_name_here/xbox-smartglass-core-python.git

3. Instale su copia local en un entorno virtual. Así es como configuras tu bifurcación para el desarrollo local.

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

5. Crea una rama para el desarrollo local ::

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

6. Haga sus cambios.

7. Antes de empujar los cambios a GIT, verifique que realmente funcionen

 pytest

8. Comprometa tus cambios y empuja tu rama a GitHub ::

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

9. Envíe una solicitud de extracción a través del sitio web de GitHub.

Pulsa de directrices de solicitud

Antes de enviar una solicitud de extracción, verifique que cumpla con estas pautas:

1. El código incluye pruebas unitarias.
2. El código agregado se nombra y documenta correctamente.
3. En cambios importantes, el ReadMe se actualiza.
4. Ejecute pruebas / peluches localmente antes de empujar a remoto.

Créditos

¡Felicitaciones a Joelday por descubrir primero la comunicación AuxiliaryStream / TitLechannel! Puede encontrar la implementación original aquí: SmartGlass.csharp

Este paquete utiliza partes de CookieCutter y la plantilla de proyecto Audreyr/CookieCutter-Pypackage