xbox smartglass core python

Xbox-smartglass-core

Esta biblioteca fornece a base principal do protocolo Smartglass que é usado com o console de jogos Xbox One

Para informações detalhadas, consulte a documentação: https://openxbox.org/smartglass-documentation

NOTA: Como 29.02.2020, os seguintes módulos são integrados ao núcleo: Stump, auxiliar e servidor de repouso Nota: O nano módulo ainda é oferecido separadamente

Características

• Liga / desliga o console
• Obter informações do sistema (executando aplicativo/jogo/título, versão do painel)
• Controle de media player (vendo ID de conteúdo, aplicativo de conteúdo, ações de reprodução etc.)
• Protocolo de Stump (streaming de TV ao vivo / controle de IR)
• Protocolo de fluxo de título / auxiliar (App Fallout 4 Companion)
• Acionar gamedvr remotamente
• Servidor de repouso

Grandes estruturas usadas

• Xbox webapi https://github.com/openxbox/xbox-webapi-python
• Construct - análise binária https://construct.readthedocs.io/
• Criptografia - Criptografia 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 App https://github.com/urwid/urwid
• Pydantic - JSON Models https://github.com/samuelcolvin/pydantic

Instalar

Via pip

 pip install xbox-smartglass-core

Veja o final deste Readme para obter instruções direcionadas ao desenvolvimento.

Como usar

Existem vários utilitários de linha de comando para conferir ::

 xbox-cli

Algumas funcionalidades, como o registro GameDVR, requer autenticação com sua conta da Microsoft para validar que você tem o direito de acionar essa ação.

Para autenticar / obter tokens de autenticação, use ::

 xbox-authenticate

Servidor de repouso

Inicie o daemon do servidor

Informações de uso

Exemplo de 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)

Exemplo de rede local:

192.168.0.100 é o endereço IP do seu computador executando o 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)

Rest API

Como a migração da estrutura do Flask para o FASTAPI, há uma boa documentação do OpenAPI disponível:

http: // {ipaddress}: {porta}/docs

Autenticação

Se o seu servidor executar em outra coisa que 127.0.0.1:5557 ou 127.0.0.1:8080 você precisará registrar seu próprio aplicativo OAuth no anúncio do Azure e fornecer parâmetros apropriados ao ponto de final de login do servidor restante.

Confira: https://github.com/openxbox/xbox-webapi-python/blob/master/readme.md

Fallout 4 Relay Service

Para encaminhar a comunicação do título do Xbox para o seu host local para usar aplicações ou extensões de Fallout 4 Pip Boy de terceiros

 xbox-fo4-relay

Capturas de tela

Aqui você pode ver o Smartglass TUI (interface do usuário de texto):

Fluxo de trabalho de desenvolvimento

Pronto para contribuir? Veja como configurar xbox-smartglass-core-python para o desenvolvimento local.

1. Fork o repositório xbox-smartglass-core-python no GitHub.
2. Clone o seu garfo localmente

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

3. Instale sua cópia local em um ambiente virtual. É assim que você configura seu garfo para o desenvolvimento local

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

5. Crie uma filial para o desenvolvimento local ::

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

6. Faça suas alterações.

7. Antes de empurrar as mudanças no Git, verifique se elas realmente funcionam

 pytest

8. Compreenda suas mudanças e empurre seu ramo para o Github ::

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

9. Envie uma solicitação de tração no site do GitHub.

Puxe as diretrizes de solicitação

Antes de enviar uma solicitação de tração, verifique se ele atende a estas diretrizes:

1. O código inclui testes de unidade.
2. O código adicionado é nomeado e documentado corretamente.
3. Nas principais alterações, o ReadMe é atualizado.
4. Execute testes / linha localmente antes de pressionar para o controle remoto.

Créditos

Parabéns a Joelday por descobrir a comunicação Auxiliarstream / Titlechannel primeiro! Você pode encontrar a implementação original aqui: Smartglass.csharp

Este pacote usa partes do CookieCutter e o modelo de projeto Audreyr/CookieCutter-Pypackage