让Android手机、平板或车机成为无线CarPlay接收端，通过系统热点与蓝牙连接iPhone，显示画面并播放声音。

快速入门 · 主要功能 · 其他平台 · 源码构建 · 来源与许可

其他设备：MacPlay · WinPlay

• Android9（API28）及以上，具备移动热点、蓝牙和视频解码能力。
• 支持CarPlay的iPhone，开启Wi-Fi与蓝牙并允许CarPlay连接。
• Android端使用WPA2系统热点，密码为8—63位。
• 安装包含可用配件认证资源的APK；自行构建时按下文配置认证目录。

在GitHubReleases获取APK，或从源码构建。应用包名为com.androidplay.app，当前版本1.2.0。

1. 在Android端安装APK，打开AndroidPlay并按系统提示授权。
2. 在Android系统设置中开启WPA2热点，让iPhone加入。建议开启热点时不要同时连接其他无线局域网。
3. 两端开启蓝牙，首次使用先完成系统蓝牙配对。
4. 点击“自动获取热点信息”；读取失败时，在弹窗中填写系统热点的实际名称和密码。
5. 进入“CarPlay设置→iPhone选择”，选择已配对的iPhone。
6. 点击“打开CarPlay”，在iPhone上确认允许连接。

热点未开启时，Android16及以上会尝试请求系统开启；系统拒绝、接口不可用或旧版Android会引导手动开启。厂商限制可能影响热点状态和密码读取，应用不会用仅本地热点代替系统移动热点。

• 无线连接：Android系统热点承载音视频，蓝牙负责连接引导。

• 全屏画面：支持横屏与竖屏方向，CarPlay默认横屏，按屏幕物理像素请求视频。

• 连接管理：通过前台服务保持会话，可从CarPlay返回首页；断开后关闭画面并清理音频与媒体会话。

• 帧率选择：30/60/90/120fps，默认60fps，高帧率启动失败后按120→90→60回退。

• 声音与设备：实时调整媒体/通话音量，分别选择系统可见的输入和输出设备。

• 系统媒体控件：在通知栏、锁屏和播放面板显示歌曲、封面与进度，回传播放、暂停、切歌及可用的进度跳转。

• 关于与更新：查看版本、检查GitHub正式发行版，支持自动更新通知、APK下载入口与TXT日志导出。

使用Android设备时选择AndroidPlay；如果更习惯在电脑上操作CarPlay，可以看看下面两个桌面项目。

首页提供“打开CarPlay”“自动获取热点信息”和“CarPlay设置”三个入口。设置页使用逐级导航，可通过顶部返回入口或Android返回键返回。

语言选项位于“CarPlay设置→语言”。默认跟随Android系统；简体中文和繁體中文按系统语言地区匹配，其他系统语言使用English。语言切换覆盖AndroidPlay首页、设置、提示和连接通知，不改变iPhone上的CarPlay语言，也不中断会话。

主动断开、iPhone断开或连接丢失时，CarPlay页面自动关闭并恢复AndroidPlay首页。

更改显示或帧率不会自动重连。回到首页点击“打开CarPlay”时，设置有变化会重新协商；设置未变化则返回已有画面。投屏页的Android返回键向CarPlay发送返回操作，CarPlay中的AndroidPlay入口可返回首页并保持连接。

应用按显示器最高物理分辨率模式和所选方向请求视频，不使用dp、窗口尺寸或系统缩放倍率。物理尺寸按Android提供的xdpi/ydpi换算；实际布局受iPhone及设备显示策略影响。

120的视频启动失败后依次尝试90和60，90失败后尝试60；认证前失败、主动断开或已出画面后的断线不触发回退。降档只影响当前连接，不更改保存档位，也不插帧。实际帧率取决于iPhone、网络和解码能力。

收到视频后，系统Toast显示解码尺寸和根据运动峰值估算的帧率档位。它反映解码输出采样，不是屏幕刷新率或协议确认值；静止画面可能暂不显示结果。

音乐与导航使用媒体音量，通话使用通话音量，Siri保留独立音频用途。输入/输出默认跟随系统，设备选择立即应用；设备拔出后暂用系统默认路由，重新接入时恢复偏好。具体路由由Android和设备驱动决定。

封面按曲目身份关联，标题或歌词变化不作为切歌，迟到的上一首封面不会覆盖新歌。QQ音乐等App通过标题字段发送的歌词可在媒体标题位置显示，本版没有独立歌词字段。音乐App提供时长并允许跳转时，可拖动系统进度条；未提供的字段可能为空，应用不会从网络搜索封面。

进入“CarPlay设置”最后的“关于”页，查看应用版本与构建号，点击“检查更新”对比GitHub正式发行版，并打开新版APK或发行说明。

“自动检查更新”默认开启，应用启动或回到前台时每天检查一次。允许通知权限后会通过系统通知提醒新版；未授权时在应用内提示，同一版本确认后不重复提醒。手动检查不受每日频率限制，网络或GitHub访问失败时显示实际错误。通过浏览器下载APK后，由你确认安装，不自动安装。

点击“导出日志”，在系统文件选择器中指定保存位置，即可导出最近连接记录为TXT。日志会过滤网络密码、认证内容与常见设备标识，不导出认证文件或应用设置；不需要额外的存储权限。没有连接记录时会提示暂无日志。

拒绝麦克风权限不阻止连接，但无法使用对应语音输入。已拒绝的权限可从“CarPlay设置→检查应用权限”或系统应用设置重新授权。

使用AndroidStudio打开工程并配置JDK、AndroidSDK与NDK。工程采用Gradle9.7.1、AGP9.4.1、compileSdk37、targetSdk35、minSdk28和NDK29.0.14206865。版本见应用配置、依赖配置与GradleWrapper。

认证文件放在仓库外，目录结构为：

runtime-assets/
└── offline-mfi/
    ├── identity.pk8
    └── certificate.p7b

将ANDROIDPLAY_AUTH_ASSETS_DIR设为包含offline-mfi的资源根目录，使用有权使用且互相匹配的文件。APK签名证书不能代替CarPlay配件认证。macOS默认目录为~/Library/Application Support/AndroidPlay/runtime-assets。

macOS/Linux在仓库根目录执行：

export ANDROIDPLAY_AUTH_ASSETS_DIR="$HOME/AndroidPlay-runtime-assets"
./scripts/build-androidplay.sh

脚本生成build/AndroidPlay.apk。Windows的PowerShell示例：

$env:ANDROIDPLAY_AUTH_ASSETS_DIR = Join-Path $HOME 'AndroidPlay-runtime-assets'
.\gradlew.bat :mobile:assembleStandaloneDebug

Windows产物位于mobile/build/outputs/apk/debug/mobile-debug.apk。这些命令生成调试签名APK，不同签名不能直接覆盖安装。正常构建会将认证资源打入APK；缺失文件时构建会失败。公开分发APK前应确认资源允许相应分发，见认证来源说明。

源码树不包含认证私钥或证书。androidplay.sourceOnly构建模式不接入认证资源，其APK无法完成CarPlay认证，不作为可连接的发行包。

1.2.0加入跟随系统、简体中文、繁體中文与English四种应用语言选项，首页、设置、连接提示及通知统一切换；主动与被动断开都会关闭CarPlay页面并恢复首页。

1.1.0整理首页与逐级设置，加入显示方向选择、实时音量与音频设备、系统媒体控件、封面关联及进度跳转，完善断开清理和高帧率回退。设置变更在下次主动连接时应用，首页保留热点获取与权限引导。

AndroidPlay基于DiPlay，接收器源自xcertplay。原有代码、文档和素材的版权归各自权利人，保留源码中的版权与SPDX标识。

仓库包含GPLv3与AGPLv3相关代码：根目录保留GPLv3，首页相关许可见DiAuto的AGPL文本。第三方依赖和素材见第三方声明，图标源文件见SVG。分发时应按所用部分及组合方式履行适用许可要求，提供对应源码、构建资料和声明。

认证数据和商标不因项目代码许可获得再分发授权。AndroidPlay是独立修改项目，不代表Apple或上游作者，不声称获得MFi认证。不要公开认证私钥、热点密码或含个人信息的日志与截图。