Xbox One SmartGlass Rest API
xbox-smartglass-rest的Python项目详细描述
Xbox智能玻璃架
开源Xbox One SmartGlass Rest服务器。
有关详细信息,请查看文档:(https://openxbox.github.io)
依赖性
- python>;=3.5
- Xbox SmartGlass树桩(https://pypi.org/project/xbox-smartglass-stump/)
- 烧瓶(https://pypi.org/project/Flask/)
安装
通过PIP:
pip install xbox-smartglass-rest
如何使用
启动服务器:
$ xbox-rest-server
认证
从头开始验证
For non-2FA enabled account: http://localhost:5557/auth/login For 2FA: http://localhost:5557/auth/oauth # Store tokens on valid authentication http://localhost:5557/auth/store
从磁盘加载令牌
http://localhost:5557/auth/load http://localhost:5557/auth/refresh
2fa oauth-邮政
# Get authorize url GET http://localhost:5557/auth/url Response-Parameters (JSON): authorization_url # Submit redirect url POST http://localhost:5557/auth/oauth Request-Parameters: redirect_uri
常规(非2FA)登录-发布
POST http://localhost:5557/auth/login Request-Parameters: email, password
一般用法
查看所有api端点:
http://localhost:5557
常用用法:
# (Optional) Poweron console http://localhost:5557/device/<liveid>/poweron # NOTE: You can specify device by ip: /device/<liveid>/poweron?addr=192.168.0.123 # Enumerate devices on network # NOTE: You can enumerate device by specific ip: /device?addr=192.168.0.123 http://localhost:5557/device # Connect to console # NOTE: You can connect anonymously: /connect?anonymous=true # .. if console allows it .. http://localhost:5557/device/<liveid>/connect # Use other API endpoints ...
已知问题
- 查找、报告和/或修复它们;)
错误报告
报告错误时,请确保提供以下端点的输出
http://localhost:5557/versions
贡献
- 报告错误/建议功能
- 改进/添加端点
学分
这个包使用Cookiecutter和audreyr/cookiecutter-pypackage项目模板的一部分。
历史记录
0.9.8(2018-11-14)
- python 3.7兼容性
0.9.7(2018-11-05)
- PIN Xbox SmartGlass核心要求
- 提供addr query时筛选返回的控制台
- 显示控制台状态中的最后一个错误
0.9.6(2018-10-04)
- 返回唯一索引终结点
- 创建常见问题解答
- 总是用新的令牌刷新XBL客户端并实现IP-In/设备
- 通过/设备公开IP地址发现?地址=192.168.0.123
- 始终使用新令牌刷新XBL客户端
- 添加gamedvr端点
0.9.5(2018-08-16)
- 添加应用程序类型并修复媒体状态
0.9.4(2018-08-14)
- 添加/web/titlehistory端点
- 启用logfile cmdline参数
- 从/launch/<;app-id>;和/media/seek/<;seek-position>;
- 标准化媒体命令和输入键大小写
- 清除状态代码和验证路由
- 添加友好名称并显示TitleHub中的图像到控制台状态响应(如果已验证)
- 启动时尽最大努力加载和刷新令牌,成功验证时自动转储令牌文件
- 简化验证URL端点
- 将应用程序重组为更模块化
- 添加xboxliveclient和endpoint/web/title/<;title\u id>;以下载友好名称和显示图像
- 通过post to/connect提供anonymous=true时允许匿名连接
- Pin Xbox SmartGlass Stump版本
- 添加/media/seek端点
- 添加/版本端点
- 重写身份验证终结点,支持OAuth和常规身份验证
- 将终结点/身份验证重命名为/身份验证
0.9.3(2018-08-08)
- 重命名/状态为/控制台状态
0.9.2(2018-08-04)
- stump<;headend、livetv、调谐器列表>;端点
- 添加控制台标志
- 准备纳米端点
- 稍微调整身份验证终结点
- 允许匿名连接
0.9.1(2018-08-04)
- 小装饰
0.9.0(2018-08-04)
- 在github上首次提交