xbox smartglass core python

xbox-smartglass-core

이 라이브러리는 Xbox One Gaming Console과 함께 사용되는 SmartGlass 프로토콜의 핵심 기반을 제공합니다.

심도있는 정보는 문서를 확인하십시오 : https://openxbox.org/smartglass-documentation

참고 : 29.02.2020 이후 다음 모듈은 코어에 통합되어 있습니다 : Stump, Auxiliary, Rest-Server 참고 : Nano 모듈은 여전히 ​​별도로 제공됩니다.

특징

• 콘솔 전원 켜기 / 끄기
• 시스템 정보 가져 오기 (앱/게임/제목 실행, 대시 보드 버전)
• 미디어 플레이어 제어 (콘텐츠 ID, 컨텐츠 앱, 재생 동작 등보기)
• 그루터기 프로토콜 (Live-TV 스트리밍 / IR 제어)
• Title / Auxiliary Stream 프로토콜 (Fe Fallout 4 Companion App)
• 원격으로 GamedVR을 트리거합니다
• REST 서버

사용 된 주요 프레임 워크

• Xbox webapi https://github.com/openxbox/xbox-webapi-python
• 구성 - 이진 구문 분석 https://construct.readthedocs.io/
• 암호화 -Cryptography Magic https://cryptography.io/en/stable/
• DPKT -PCAP 파싱 https://dpkt.readthedocs.io/en/latest/
• Fastapi -Rest Api https://github.com/tiangolo/fastapi
• urwid -tui 앱 https://github.com/urwid/urwid
• Pydantic -JSON 모델 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

플라스크 프레임 워크에서 Fastapi로 마이그레이션되기 때문에 멋진 OpenApi 문서가 있습니다.

http : // {iPaddress} : {port}/docs

입증

서버가 127.0.0.1:5557 또는 127.0.0.1:8080 이외의 다른 것으로 실행되면 Azure AD 에 자신의 OAUTH 응용 프로그램을 등록하고 나머지 서버의 로그인 엔드 포인트에 적절한 매개 변수를 제공해야합니다.

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

Fallout 4 릴레이 서비스

제목 통신을 Xbox에서 로컬 호스트로 전달하려면 타사 파티 낙진 4 PIP 보이 응용 프로그램 또는 확장

 xbox-fo4-relay

스크린 샷

여기에서 SmartGlass Tui (텍스트 사용자 인터페이스)를 볼 수 있습니다.

개발 워크 플로

기여할 준비가 되셨습니까? 지역 개발을 위해 xbox-smartglass-core-python 설정하는 방법은 다음과 같습니다.

1. Github에서 xbox-smartglass-core-python Repo를 포크로.
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. 원격으로 밀기 전에 테스트 / 라인을 로컬로 실행합니다.

크레딧

보조 스트림 / TitleChannel Communication을 먼저 파악한 Joelday에게 Kudos! 여기에서 원래 구현을 찾을 수 있습니다 : SmartGlass.csharp

이 패키지는 CookieCutter의 일부와 Audreyr/Cookiecutter-Pypackage 프로젝트 템플릿을 사용합니다.