# MYT SDK
魔云腾SDK通用包 - 用于自动下载、管理和启动MYT SDK
## 描述
MYT SDK是一个Python包，用于简化MYT SDK的下载、安装和启动过程。它会自动检测系统中是否已安装SDK，如果没有则从指定URL下载并解压到用户缓存目录，然后启动SDK进程。
## 特性
- 🚀 自动下载和安装MYT SDK
- 📁 智能缓存管理（使用系统缓存目录）
- 🔍 进程检测（避免重复启动）
- 🛡️ 完善的错误处理和日志记录
- 💻 Windows
- 🎯 简单的命令行接口
- 🌐 完整的API客户端支持
- 📱 容器管理和设备控制
- 🎥 摄像头和传感器配置
- 📍 位置服务和代理管理
- 📊 GitHub仓库实时监控和统计
## 安装
### 从PyPI安装（推荐）
```bash
pip install myt-sdk
```
### 从源码安装
```bash
git clone https://github.com/moyunteng/myt-sdk.git
cd myt-sdk
pip install -e .
```
## 使用方法
### 命令行使用
#### 初始化SDK（下载并启动）
```bash
# 基本初始化
myt-sdk init
# 强制重新下载
myt-sdk init --force
# 只下载不启动
myt-sdk init --no-start
# 使用自定义缓存目录
myt-sdk init --cache-dir /path/to/cache
# 启用详细日志
myt-sdk init --verbose
```
#### 查看SDK状态
```bash
myt-sdk status
```
### Python代码使用
#### SDK管理器
```python
from py_myt import MYTSDKManager
# 创建SDK管理器
sdk_manager = MYTSDKManager()
# 检查SDK状态
status = sdk_manager.get_status()
print(f"SDK已安装: {status['installed']}")
print(f"SDK正在运行: {status['running']}")
# 初始化SDK
result = sdk_manager.init()
print(f"初始化结果: {result}")
```
#### API客户端
```python
from py_myt import create_client
from py_myt.exceptions import MYTSDKError
# 创建API客户端
client = create_client(base_url="http://192.168.1.100:5000")
try:
# 容器管理
containers = client.get_containers(ip="192.168.1.100")
print(f"容器列表: {containers}")
# 创建Android容器
result = client.create_android_container(
ip="192.168.1.100",
index=1,
name="my_container",
image_addr="android_image"
)
print(f"容器创建结果: {result}")
# 设置摄像头推流
client.set_camera_stream(
ip="192.168.1.100",
name="my_container",
v_type=1, # RTMP流
resolution=1, # 1920x1080@30
addr="rtmp://live.example.com/stream"
)
# 配置S5代理
client.set_s5_connection(
ip="192.168.1.100",
name="my_container",
s5ip="127.0.0.1",
s5port="1080",
s5user="username",
s5pwd="password"
)
except MYTSDKError as e:
print(f"API调用失败: {e}")
```
## API功能
### 容器管理
- 创建/删除Android容器
- 容器状态查询和控制
- 批量容器操作
- 容器配置管理
### 设备控制
- 设备信息查询
- 主机版本管理
- 文件上传下载
- 随机设备信息生成
### 摄像头功能
- 获取摄像头推流信息
- 设置摄像头旋转和镜像
- 配置RTMP/WebRTC推流
- 图片显示设置
### 传感器配置
- 运动传感器灵敏度调节
- 摇一摇功能开关
- 传感器状态监控
### 位置服务
- IP智能定位
- 手动设置设备位置
- 多语言环境支持
### 代理管理
- S5代理连接设置
- 代理状态控制
- 域名解析配置
### 视频处理
- 视频文件预处理
- 播放优化
### GitHub监控
- 实时访问统计
- 仓库流量分析
- 下载量监控
- 用户行为追踪
## GitHub仓库
### 统计
[](https://github.com/kuqitt/myt_sdk/stargazers)
[](https://github.com/kuqitt/myt_sdk/network/members)
[](https://github.com/kuqitt/myt_sdk/watchers)
[](https://github.com/kuqitt/myt_sdk/issues)
[](https://github.com/kuqitt/myt_sdk/pulls)
### 下载统计
[](https://github.com/kuqitt/myt_sdk/releases)
[](https://github.com/kuqitt/myt_sdk/releases/latest)
[](https://pypi.org/project/myt-sdk/)
### 代码质量
[](https://github.com/kuqitt/myt_sdk)
[](https://github.com/kuqitt/myt_sdk)
[](https://github.com/kuqitt/myt_sdk)
[](https://github.com/kuqitt/myt_sdk)
### 活跃度统计
[](https://github.com/kuqitt/myt_sdk/graphs/commit-activity)
[](https://github.com/kuqitt/myt_sdk/commits/main)
[](https://github.com/kuqitt/myt_sdk/graphs/contributors)
## 文档
- [API客户端文档](docs/api_client.md)
- [高级API方法文档](docs/advanced_api_methods.md)
- [示例代码](examples/)
## 开发
### 运行测试
```bash
# 运行所有测试
pytest
# 运行特定测试文件
pytest tests/test_api_client.py
pytest tests/test_new_api_methods.py
# 运行测试并显示覆盖率
pytest --cov=py_myt
```
### 代码格式化
```bash
black py_myt/
```
### 类型检查
```bash
mypy py_myt/
```
```bash
flake8 py_myt/
```
## 许可证
MIT License
## 贡献
欢迎提交Issue和Pull Request！
## 更新日志
### 0.2.0
- 新增完整的API客户端支持
- 添加容器管理功能
- 实现摄像头控制API
- 添加传感器配置功能
- 支持位置服务和代理管理
- 新增视频预处理功能
- 完善测试覆盖率
- 添加详细文档和示例
### 0.1.0
- 初始版本
Raw data
{
"_id": null,
"home_page": "https://github.com/kuqitt/myt_sdk",
"name": "myt-sdk",
"maintainer": "MYT Team",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "kuqitt1@163.com",
"keywords": "myt, sdk, automation, android, container, api, client, device, management, camera, sensor, location, proxy, video, streaming, rtmp, webrtc, monitoring, github",
"author": "MYT Team",
"author_email": "kuqitt1@163.com",
"download_url": "https://files.pythonhosted.org/packages/e4/21/6d8822933dc905c9d055bc63f16839af709de4a47455752f784faa2da924/myt_sdk-1.1.5.tar.gz",
"platform": "Windows",
"description": "# MYT SDK\r\n\r\n\u9b54\u4e91\u817eSDK\u901a\u7528\u5305 - \u7528\u4e8e\u81ea\u52a8\u4e0b\u8f7d\u3001\u7ba1\u7406\u548c\u542f\u52a8MYT SDK\r\n\r\n## \u63cf\u8ff0\r\n\r\nMYT SDK\u662f\u4e00\u4e2aPython\u5305\uff0c\u7528\u4e8e\u7b80\u5316MYT SDK\u7684\u4e0b\u8f7d\u3001\u5b89\u88c5\u548c\u542f\u52a8\u8fc7\u7a0b\u3002\u5b83\u4f1a\u81ea\u52a8\u68c0\u6d4b\u7cfb\u7edf\u4e2d\u662f\u5426\u5df2\u5b89\u88c5SDK\uff0c\u5982\u679c\u6ca1\u6709\u5219\u4ece\u6307\u5b9aURL\u4e0b\u8f7d\u5e76\u89e3\u538b\u5230\u7528\u6237\u7f13\u5b58\u76ee\u5f55\uff0c\u7136\u540e\u542f\u52a8SDK\u8fdb\u7a0b\u3002\r\n\r\n## \u7279\u6027\r\n\r\n- \ud83d\ude80 \u81ea\u52a8\u4e0b\u8f7d\u548c\u5b89\u88c5MYT SDK\r\n- \ud83d\udcc1 \u667a\u80fd\u7f13\u5b58\u7ba1\u7406\uff08\u4f7f\u7528\u7cfb\u7edf\u7f13\u5b58\u76ee\u5f55\uff09\r\n- \ud83d\udd0d \u8fdb\u7a0b\u68c0\u6d4b\uff08\u907f\u514d\u91cd\u590d\u542f\u52a8\uff09\r\n- \ud83d\udee1\ufe0f \u5b8c\u5584\u7684\u9519\u8bef\u5904\u7406\u548c\u65e5\u5fd7\u8bb0\u5f55\r\n- \ud83d\udcbb Windows\r\n- \ud83c\udfaf \u7b80\u5355\u7684\u547d\u4ee4\u884c\u63a5\u53e3\r\n- \ud83c\udf10 \u5b8c\u6574\u7684API\u5ba2\u6237\u7aef\u652f\u6301\r\n- \ud83d\udcf1 \u5bb9\u5668\u7ba1\u7406\u548c\u8bbe\u5907\u63a7\u5236\r\n- \ud83c\udfa5 \u6444\u50cf\u5934\u548c\u4f20\u611f\u5668\u914d\u7f6e\r\n- \ud83d\udccd \u4f4d\u7f6e\u670d\u52a1\u548c\u4ee3\u7406\u7ba1\u7406\r\n- \ud83d\udcca GitHub\u4ed3\u5e93\u5b9e\u65f6\u76d1\u63a7\u548c\u7edf\u8ba1\r\n\r\n## \u5b89\u88c5\r\n\r\n### \u4ecePyPI\u5b89\u88c5\uff08\u63a8\u8350\uff09\r\n\r\n```bash\r\npip install myt-sdk\r\n```\r\n\r\n### \u4ece\u6e90\u7801\u5b89\u88c5\r\n\r\n```bash\r\ngit clone https://github.com/moyunteng/myt-sdk.git\r\ncd myt-sdk\r\npip install -e .\r\n```\r\n\r\n## \u4f7f\u7528\u65b9\u6cd5\r\n\r\n### \u547d\u4ee4\u884c\u4f7f\u7528\r\n\r\n#### \u521d\u59cb\u5316SDK\uff08\u4e0b\u8f7d\u5e76\u542f\u52a8\uff09\r\n\r\n```bash\r\n# \u57fa\u672c\u521d\u59cb\u5316\r\nmyt-sdk init\r\n\r\n# \u5f3a\u5236\u91cd\u65b0\u4e0b\u8f7d\r\nmyt-sdk init --force\r\n\r\n# \u53ea\u4e0b\u8f7d\u4e0d\u542f\u52a8\r\nmyt-sdk init --no-start\r\n\r\n# \u4f7f\u7528\u81ea\u5b9a\u4e49\u7f13\u5b58\u76ee\u5f55\r\nmyt-sdk init --cache-dir /path/to/cache\r\n\r\n# \u542f\u7528\u8be6\u7ec6\u65e5\u5fd7\r\nmyt-sdk init --verbose\r\n```\r\n\r\n#### \u67e5\u770bSDK\u72b6\u6001\r\n\r\n```bash\r\nmyt-sdk status\r\n```\r\n\r\n### Python\u4ee3\u7801\u4f7f\u7528\r\n\r\n#### SDK\u7ba1\u7406\u5668\r\n\r\n```python\r\nfrom py_myt import MYTSDKManager\r\n\r\n# \u521b\u5efaSDK\u7ba1\u7406\u5668\r\nsdk_manager = MYTSDKManager()\r\n\r\n# \u68c0\u67e5SDK\u72b6\u6001\r\nstatus = sdk_manager.get_status()\r\nprint(f\"SDK\u5df2\u5b89\u88c5: {status['installed']}\")\r\nprint(f\"SDK\u6b63\u5728\u8fd0\u884c: {status['running']}\")\r\n\r\n# \u521d\u59cb\u5316SDK\r\nresult = sdk_manager.init()\r\nprint(f\"\u521d\u59cb\u5316\u7ed3\u679c: {result}\")\r\n```\r\n\r\n#### API\u5ba2\u6237\u7aef\r\n\r\n```python\r\nfrom py_myt import create_client\r\nfrom py_myt.exceptions import MYTSDKError\r\n\r\n# \u521b\u5efaAPI\u5ba2\u6237\u7aef\r\nclient = create_client(base_url=\"http://192.168.1.100:5000\")\r\n\r\ntry:\r\n # \u5bb9\u5668\u7ba1\u7406\r\n containers = client.get_containers(ip=\"192.168.1.100\")\r\n print(f\"\u5bb9\u5668\u5217\u8868: {containers}\")\r\n \r\n # \u521b\u5efaAndroid\u5bb9\u5668\r\n result = client.create_android_container(\r\n ip=\"192.168.1.100\",\r\n index=1,\r\n name=\"my_container\",\r\n image_addr=\"android_image\"\r\n )\r\n print(f\"\u5bb9\u5668\u521b\u5efa\u7ed3\u679c: {result}\")\r\n \r\n # \u8bbe\u7f6e\u6444\u50cf\u5934\u63a8\u6d41\r\n client.set_camera_stream(\r\n ip=\"192.168.1.100\",\r\n name=\"my_container\",\r\n v_type=1, # RTMP\u6d41\r\n resolution=1, # 1920x1080@30\r\n addr=\"rtmp://live.example.com/stream\"\r\n )\r\n \r\n # \u914d\u7f6eS5\u4ee3\u7406\r\n client.set_s5_connection(\r\n ip=\"192.168.1.100\",\r\n name=\"my_container\",\r\n s5ip=\"127.0.0.1\",\r\n s5port=\"1080\",\r\n s5user=\"username\",\r\n s5pwd=\"password\"\r\n )\r\n \r\nexcept MYTSDKError as e:\r\n print(f\"API\u8c03\u7528\u5931\u8d25: {e}\")\r\n```\r\n\r\n## API\u529f\u80fd\r\n\r\n### \u5bb9\u5668\u7ba1\u7406\r\n- \u521b\u5efa/\u5220\u9664Android\u5bb9\u5668\r\n- \u5bb9\u5668\u72b6\u6001\u67e5\u8be2\u548c\u63a7\u5236\r\n- \u6279\u91cf\u5bb9\u5668\u64cd\u4f5c\r\n- \u5bb9\u5668\u914d\u7f6e\u7ba1\u7406\r\n\r\n### \u8bbe\u5907\u63a7\u5236\r\n- \u8bbe\u5907\u4fe1\u606f\u67e5\u8be2\r\n- \u4e3b\u673a\u7248\u672c\u7ba1\u7406\r\n- \u6587\u4ef6\u4e0a\u4f20\u4e0b\u8f7d\r\n- \u968f\u673a\u8bbe\u5907\u4fe1\u606f\u751f\u6210\r\n\r\n### \u6444\u50cf\u5934\u529f\u80fd\r\n- \u83b7\u53d6\u6444\u50cf\u5934\u63a8\u6d41\u4fe1\u606f\r\n- \u8bbe\u7f6e\u6444\u50cf\u5934\u65cb\u8f6c\u548c\u955c\u50cf\r\n- \u914d\u7f6eRTMP/WebRTC\u63a8\u6d41\r\n- \u56fe\u7247\u663e\u793a\u8bbe\u7f6e\r\n\r\n### \u4f20\u611f\u5668\u914d\u7f6e\r\n- \u8fd0\u52a8\u4f20\u611f\u5668\u7075\u654f\u5ea6\u8c03\u8282\r\n- \u6447\u4e00\u6447\u529f\u80fd\u5f00\u5173\r\n- \u4f20\u611f\u5668\u72b6\u6001\u76d1\u63a7\r\n\r\n### \u4f4d\u7f6e\u670d\u52a1\r\n- IP\u667a\u80fd\u5b9a\u4f4d\r\n- \u624b\u52a8\u8bbe\u7f6e\u8bbe\u5907\u4f4d\u7f6e\r\n- \u591a\u8bed\u8a00\u73af\u5883\u652f\u6301\r\n\r\n### \u4ee3\u7406\u7ba1\u7406\r\n- S5\u4ee3\u7406\u8fde\u63a5\u8bbe\u7f6e\r\n- \u4ee3\u7406\u72b6\u6001\u63a7\u5236\r\n- \u57df\u540d\u89e3\u6790\u914d\u7f6e\r\n\r\n### \u89c6\u9891\u5904\u7406\r\n- \u89c6\u9891\u6587\u4ef6\u9884\u5904\u7406\r\n- \u64ad\u653e\u4f18\u5316\r\n\r\n### GitHub\u76d1\u63a7\r\n- \u5b9e\u65f6\u8bbf\u95ee\u7edf\u8ba1\r\n- \u4ed3\u5e93\u6d41\u91cf\u5206\u6790\r\n- \u4e0b\u8f7d\u91cf\u76d1\u63a7\r\n- \u7528\u6237\u884c\u4e3a\u8ffd\u8e2a\r\n\r\n## GitHub\u4ed3\u5e93\r\n\r\n### \u7edf\u8ba1\r\n\r\n[](https://github.com/kuqitt/myt_sdk/stargazers)\r\n[](https://github.com/kuqitt/myt_sdk/network/members)\r\n[](https://github.com/kuqitt/myt_sdk/watchers)\r\n[](https://github.com/kuqitt/myt_sdk/issues)\r\n[](https://github.com/kuqitt/myt_sdk/pulls)\r\n\r\n### \u4e0b\u8f7d\u7edf\u8ba1\r\n\r\n[](https://github.com/kuqitt/myt_sdk/releases)\r\n[](https://github.com/kuqitt/myt_sdk/releases/latest)\r\n[](https://pypi.org/project/myt-sdk/)\r\n\r\n### \u4ee3\u7801\u8d28\u91cf\r\n\r\n[](https://github.com/kuqitt/myt_sdk)\r\n[](https://github.com/kuqitt/myt_sdk)\r\n[](https://github.com/kuqitt/myt_sdk)\r\n[](https://github.com/kuqitt/myt_sdk)\r\n\r\n### \u6d3b\u8dc3\u5ea6\u7edf\u8ba1\r\n\r\n[](https://github.com/kuqitt/myt_sdk/graphs/commit-activity)\r\n[](https://github.com/kuqitt/myt_sdk/commits/main)\r\n[](https://github.com/kuqitt/myt_sdk/graphs/contributors)\r\n\r\n\r\n## \u6587\u6863\r\n\r\n- [API\u5ba2\u6237\u7aef\u6587\u6863](docs/api_client.md)\r\n- [\u9ad8\u7ea7API\u65b9\u6cd5\u6587\u6863](docs/advanced_api_methods.md)\r\n- [\u793a\u4f8b\u4ee3\u7801](examples/)\r\n\r\n## \u5f00\u53d1\r\n\r\n### \u8fd0\u884c\u6d4b\u8bd5\r\n\r\n```bash\r\n# \u8fd0\u884c\u6240\u6709\u6d4b\u8bd5\r\npytest\r\n\r\n# \u8fd0\u884c\u7279\u5b9a\u6d4b\u8bd5\u6587\u4ef6\r\npytest tests/test_api_client.py\r\npytest tests/test_new_api_methods.py\r\n\r\n# \u8fd0\u884c\u6d4b\u8bd5\u5e76\u663e\u793a\u8986\u76d6\u7387\r\npytest --cov=py_myt\r\n```\r\n\r\n### \u4ee3\u7801\u683c\u5f0f\u5316\r\n\r\n```bash\r\nblack py_myt/\r\n```\r\n\r\n### \u7c7b\u578b\u68c0\u67e5\r\n\r\n```bash\r\nmypy py_myt/\r\n```\r\n\r\n```bash\r\nflake8 py_myt/\r\n```\r\n\r\n## \u8bb8\u53ef\u8bc1\r\n\r\nMIT License\r\n\r\n## \u8d21\u732e\r\n\r\n\u6b22\u8fce\u63d0\u4ea4Issue\u548cPull Request\uff01\r\n\r\n## \u66f4\u65b0\u65e5\u5fd7\r\n\r\n### 0.2.0\r\n- \u65b0\u589e\u5b8c\u6574\u7684API\u5ba2\u6237\u7aef\u652f\u6301\r\n- \u6dfb\u52a0\u5bb9\u5668\u7ba1\u7406\u529f\u80fd\r\n- \u5b9e\u73b0\u6444\u50cf\u5934\u63a7\u5236API\r\n- \u6dfb\u52a0\u4f20\u611f\u5668\u914d\u7f6e\u529f\u80fd\r\n- \u652f\u6301\u4f4d\u7f6e\u670d\u52a1\u548c\u4ee3\u7406\u7ba1\u7406\r\n- \u65b0\u589e\u89c6\u9891\u9884\u5904\u7406\u529f\u80fd\r\n- \u5b8c\u5584\u6d4b\u8bd5\u8986\u76d6\u7387\r\n- \u6dfb\u52a0\u8be6\u7ec6\u6587\u6863\u548c\u793a\u4f8b\r\n\r\n### 0.1.0\r\n- \u521d\u59cb\u7248\u672c\r\n",
"bugtrack_url": null,
"license": null,
"summary": "MYT SDK - \u9b54\u4e91\u817eSDK\u901a\u7528\u5305\uff0c\u7528\u4e8e\u81ea\u52a8\u4e0b\u8f7d\u3001\u7ba1\u7406\u548c\u542f\u52a8MYT SDK\uff0c\u652f\u6301\u5b8c\u6574\u7684API\u5ba2\u6237\u7aef\u529f\u80fd",
"version": "1.1.5",
"project_urls": {
"API Documentation": "https://github.com/kuqitt/myt_sdk/tree/main/docs",
"Bug Reports": "https://github.com/kuqitt/myt_sdk/issues",
"Changelog": "https://github.com/kuqitt/myt_sdk/blob/main/CHANGELOG.md",
"Documentation": "https://github.com/kuqitt/myt_sdk/blob/main/README.md",
"Download": "https://github.com/kuqitt/myt_sdk/archive/v1.0.0.tar.gz",
"Examples": "https://github.com/kuqitt/myt_sdk/tree/main/examples",
"Homepage": "https://github.com/kuqitt/myt_sdk",
"Source": "https://github.com/kuqitt/myt_sdk"
},
"split_keywords": [
"myt",
" sdk",
" automation",
" android",
" container",
" api",
" client",
" device",
" management",
" camera",
" sensor",
" location",
" proxy",
" video",
" streaming",
" rtmp",
" webrtc",
" monitoring",
" github"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "b825efad7eea3e33e1d51b8e383717ec33bac2e0a64efcda2501adf2bc030ae3",
"md5": "6f63d233c4cb458f48af23dadef8764f",
"sha256": "efcc33d22c54c8724aab557de0921fcb2406740444299db179a3a5881f6994d8"
},
"downloads": -1,
"filename": "myt_sdk-1.1.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6f63d233c4cb458f48af23dadef8764f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 24008,
"upload_time": "2025-07-14T12:07:28",
"upload_time_iso_8601": "2025-07-14T12:07:28.817966Z",
"url": "https://files.pythonhosted.org/packages/b8/25/efad7eea3e33e1d51b8e383717ec33bac2e0a64efcda2501adf2bc030ae3/myt_sdk-1.1.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "e4216d8822933dc905c9d055bc63f16839af709de4a47455752f784faa2da924",
"md5": "4f5ebb87e442676f79e2a2fdf2fbffbd",
"sha256": "0308ef769d28d0e8f5c47aab61ba41856646eee4f30902f5c229eb9555f2ee48"
},
"downloads": -1,
"filename": "myt_sdk-1.1.5.tar.gz",
"has_sig": false,
"md5_digest": "4f5ebb87e442676f79e2a2fdf2fbffbd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 54004,
"upload_time": "2025-07-14T12:07:30",
"upload_time_iso_8601": "2025-07-14T12:07:30.495315Z",
"url": "https://files.pythonhosted.org/packages/e4/21/6d8822933dc905c9d055bc63f16839af709de4a47455752f784faa2da924/myt_sdk-1.1.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-14 12:07:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "kuqitt",
"github_project": "myt_sdk",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "requests",
"specs": [
[
">=",
"2.25.0"
]
]
},
{
"name": "psutil",
"specs": [
[
">=",
"5.8.0"
]
]
}
],
"lcname": "myt-sdk"
}
JSON
