米乐客户端
多端畅联，稳定兼容
iOS / iPadOS
Android
Windows / macOS
H5 网页端
为保障低延迟交互、高清帧率渲染与跨端数据同步，米乐客户端针对主流智能手机、平板电脑及桌面计算设备进行了深度的底层架构优化。本页详细列示各终端操作系统版本基线、硬件配置要求、屏幕自适应规范及环境异常排查方案。
米乐客户端涵盖原生移动应用（iOS / Android）、平板大屏HD端、桌面客户端（Windows / macOS）及响应式H5网页端，支持按设备形态筛选核对兼容状态。
基于 Swift 与 Metal 图形驱动加速，支持灵动岛实时状态、Face ID 快速解锁与 ProMotion 120Hz 高刷交互。
全面适配各大厂商定制 ROM（澎湃 HyperOS、OriginOS、ColorOS、One UI），支持 Vulkan 图形渲染与后台保活机制。
针对华为 Mate / Pura / Nova 系列终端进行方舟编译器运行时调优，提供纯净模式白名单安装指引与高帧率触控同步。
专为大尺寸屏幕与折叠屏展开态设计的双栏/多栏弹性网格，折叠开合瞬间界面毫秒级无感重绘，不丢失当前会话状态。
提供独立桌面端程序与高性能 WebGL 网页端双重接入方式，支持多显示器高 DPI 缩放、快捷键唤醒及低内存常驻模式。
原生编译支持 Apple Silicon (M1/M2/M3/M4) 与 Intel x86_64 双架构，无需 Rosetta 转译即可实现超低功耗与视网膜屏细腻显示。
由于现代加密传输协议（TLS 1.3）、硬件视频解码器及系统级安全沙箱需要底层操作系统 API 的支持，米乐客户端定期更新系统版本基线。若您的设备处于“最低兼容基线”，仍可正常安装与登录，但部分高帧率动效可能自动降级；若低于最低门槛，建议直接通过现代浏览器访问 H5 网页端。
| 终端操作系统 | 最低运行版本门槛 | 推荐生产环境版本 | 内核 / 安全传输要求 | 已停止维护版本 (EOL) | 适配状态 |
|---|---|---|---|---|---|
|
Apple iOS
|
iOS 13.0 | iOS 16.0 ~ iOS 18.x | WebKit 614+ / TLS 1.3 / 64位架构 | iOS 12.x 及更早版本 | 全功能就绪 |
|
Google Android
|
Android 8.0 (API 26) | Android 12.0 ~ 15.0 | Android System WebView 95+ | Android 7.1 (Nougat) 及以下 | 全功能就绪 |
|
Apple iPadOS
|
iPadOS 13.4 | iPadOS 16.0 ~ 18.x | Metal 2+ / 多任务分屏 API | iOS 12 平板固件 | 宽屏自适应 |
|
HarmonyOS
|
HarmonyOS 2.0 | HarmonyOS 3.0 / 4.2+ | AOSP 兼容层 / 卓易通容器 & H5 | 无 (全代系支持) | 签名已认证 |
|
Microsoft Windows
|
Windows 10 (1903 x64) | Windows 10 22H2 / Win 11 | WebView2 Runtime / DirectX 11 | Win 7 / Win 8.1 / 32位系统 | 原生桌面端 |
|
Apple macOS
|
macOS 11.0 (Big Sur) | macOS 13 Ventura ~ 15+ | Universal Binary (ARM64 + x64) | macOS 10.15 Catalina 及以下 | 双架构原生 |
若您的终端系统处于停止维护状态或使用 Linux (Ubuntu/Deepin) 桌面，可通过 Chrome 90+、Safari 14+、Edge 90+ 或 Firefox 88+ 浏览器直接访问全功能 H5 网页平台，免除本地客户端安装限制。
负责界面动画光栅化、实时数据流并发解析与硬件视频流硬解。
保障多任务切换后台不杀进程，并预留静态资源包与热更新缓存空间。
支持矢量图形无损缩放，自动识别刘海屏、灵动岛与底部手势安全区。
采用 QUIC / HTTP3 与多路复用长连接技术，支持弱网断线毫秒级无感重连。
遇到安装包解析失败、安全拦截、画面掉帧或网络连接受阻时，请对照以下环境诊断矩阵快速定位原因并执行修复步骤。
若您使用的是新款折叠屏、小众定制系统或企业内网受限终端，遇到无法自行排除的兼容问题，请联系客户端技术支持团队协助定位。
核心成因：通常由以下三种情况触发：① 下载过程中网络中断导致 APK 文件末尾字节缺失（MD5校验不匹配）；② 设备系统版本低于 Android 8.0 (API 26)；③ 使用了 32位 老旧处理器运行纯 64位 (arm64-v8a) 安装包。
1. 彻底删除本地已损坏的 APK 文件，切换至稳定的 Wi-Fi 或 5G 网络重新从下载中心拉取完整安装包。
2. 进入手机「设置」→「关于本机」，确认 Android 版本不低于 8.0，且剩余可用存储空间大于 2.0 GB。
3. 避免使用第三方社交软件内置浏览器直接下载，建议使用系统自带浏览器或 Chrome 打开下载链接。
核心成因：国产定制系统默认开启了应用商店白名单机制，对通过浏览器直接下载的独立分发包（即使具备合法 V2/V3 数字签名）也会弹出安全确认提示。
• HarmonyOS 鸿蒙系统：进入「设置」→「系统和更新」→「纯净模式」，点击关闭增强防护（或输入锁屏密码选择“了解风险并继续安装”）。
• 小米 HyperOS / MIUI：在安装拦截弹窗中点击右上角「设置」图标，暂时关闭「开启安全守护」，完成安装后再恢复开启。
• OPPO / VIVO 终端：勾选弹窗中的“已了解应用来源”，输入系统锁屏密码或验证指纹即可放行安装。
核心成因：iOS 系统针对企业级签名分发或 TestFlight 以外的独立客户端，要求用户手动在系统设备管理中完成首次证书信任授权。
1. 打开 iPhone/iPad「设置」→「通用」→「VPN 与设备管理」（部分版本显示为“描述文件与设备管理”）。
2. 在“企业级APP”列表下找到对应的签名主体名称，点击进入并选择蓝色的「信任 "xxx"」按钮。
3. iOS 16 及以上附加要求：若提示需开启开发者模式，请前往「设置」→「隐私与安全性」底部找到「开发者模式」，开启开关并重启设备后完成验证。
核心成因：安卓系统的 Android System WebView 组件版本过旧（低于 v85），或者移动浏览器开启了“省流极速模式/云端压缩”、“深色模式强制反色”，破坏了现代 CSS Grid 与 WebGL 渲染管线。
1. 升级系统 WebView：在安卓应用商店搜索“Android System WebView”并将其更新至 95.0 以上版本。
2. 关闭浏览器内容劫持：若使用 UC、夸克或百度浏览器访问 H5，请在浏览器设置中关闭“云端加速/极速省流”与“强制夜间反色”，推荐使用 Chrome、Edge 或系统原生浏览器。
3. 释放显存与关闭低电量模式：手机开启低电量模式会将屏幕刷新率强制锁死在 60Hz 以下并限制 GPU 频率，关闭省电模式即可恢复 120Hz 顺滑交互。
核心成因：部分安卓机型（尤其是 6GB RAM 及以下设备）的激进后台电池优化策略会在应用退入后台 60 秒后强行挂起网络套接字（Socket）或回收进程内存。
1. 多任务卡片加锁：呼出手机系统近期任务视图，长按或下拉米乐客户端卡片，点击「锁定」图标避免被一键清理。
2. 电池优化白名单：进入「设置」→「应用管理」→ 找到本客户端 →「省电策略 / 电池优化」，将其设置为「无限制」或「允许后台高耗电」。
核心成因：设备本地系统时间与标准北京时间偏差超过 5 分钟导致 TLS 证书有效期校验失败，或公共 Wi-Fi 路由器存在地方性 DNS 污染。
1. 校准系统时钟：进入系统日期与时间设置，开启「自动设置时间」与「自动设置时区」。
2. 切换加密 DNS / 移动网络：关闭当前 Wi-Fi 切换至 4G/5G 移动数据测试；或在客户端启动页点击右上角「线路诊断」，启用内置 HTTPDNS 防劫持直连通道。
3. 关闭全局代理冲突：若设备同时开启了其他第三方 VPN 或代理规则软件，请将其关闭或将本应用加入直连分流列表。
无论您使用 iOS、Android 移动设备还是 Windows、macOS 个人电脑，均可前往下载中心获取经过数字签名校验的官方客户端安装包，或直接启用免安装 H5 网页端。
