Profile
Back to NewsBack
GitHub Trending 2 min
Reader Mode
xmz28/CarWithin: iPhone 同机 CarPlay 接收器 · iOS 实验版分发

xmz28/CarWithin: iPhone 同机 CarPlay 接收器 · iOS 实验版分发

13 hours ago

CarWithin

English · 简体中文

Platform: iOS 16.0+</a> Status: released</a> Release</a>

CarWithin 在同一台 iPhone 上启动、显示和触控本机 CarPlay。你可以直接在 iPhone 上用导航、音乐等 CarPlay 应用,也可以把画面送到同一局域网的车机浏览器、平板、电脑或另一台手机。浏览器接收支持触控回传。

下载与安装

  • 从 GitHub Releases 下载。当前版本为 1.0.3(构建 15)。
  • 下载 CarWithin-1.0.3-unsigned.ipa,用支持 IPA 的侧载工具按自己的签名方式签名并安装。按设备提示完成开发者信任或开启开发者模式。
  • 最低安装目标为 iOS/iPadOS 16.0,arm64;iOS 15 不支持安装。安装目标降低不等于所有旧系统均已实测,iOS 16.x 的本机 CarPlay、声音和后台行为仍需对应设备验证。实际可用性取决于设备、系统版本和签名方式。CarWithin 使用 iOS 私有接口,系统升级后可能需要重新验证。

快速开始

  1. 在 iPhone 上用 CarPlay。 打开 CarWithin,按提示在「Wi-Fi 与网络」保存当前 Wi-Fi 信息,然后点「启动 CarPlay」。画面出现后即可在 iPhone 上触控,或切换全屏。
  2. 用另一台设备接收。 在「设置 → 当前输出」选择「浏览器」,进入「输出设置」打开「局域网接收页」。让接收设备和 iPhone 连到同一 Wi-Fi。网络可以没有互联网,也可以使用其他设备的热点;运行 CarWithin 的 iPhone 必须加入 Wi-Fi。启动 CarPlay 后,在接收设备的浏览器打开 App 显示的 HTTP 地址。
  3. 用本机 Safari 接收。 CarPlay 启动后,进入「设置 → 输出设置」,点「在本机浏览器打开」。如果网页显示「开始播放」,点一下即可。
  4. 停止共享。 用完在 iPhone 上停止 CarPlay。局域网接收页目前没有登录校验,可访问地址的设备可以观看与触控。请在信任的网络中使用。

浏览器的 HTTP、HTTPS 与声音

| 方式 | 适用场景 | 默认端口 | | --- | --- | --- | | HTTP | 首次连接、排查网络,或浏览器需要 MSE 兼容播放时 | 9888 | | HTTPS | 浏览器支持 WebCodecs,且希望减少画面延迟时 | 9889 |

HTTP 端口在「设置 → 输出设置」修改;HTTPS 端口和证书在「设置 → HTTPS 设置」修改。HTTPS 端口留空时通常使用 HTTP 端口加 1。始终以 App 当前显示的完整地址为准。

配置 HTTPS

  1. 先在接收设备上打开 HTTP 接收页,再点「配置 HTTPS」。核对页面提示与 iPhone 日志中的证书指纹。
  2. iPhone 或 iPad 下载并安装描述文件,然后在系统「通用 → 关于本机 → 证书信任设置」中开启对该证书的完全信任。Android 下载 Android 证书,按页面指引在系统设置中安装为 CA 证书。菜单名称随系统和品牌而异。
  3. 打开 App 显示的 HTTPS 地址。如果浏览器没有 WebCodecs,网页会使用兼容播放。

使用域名地址

在「HTTPS 设置」选择地址方案:

  • 本地 IP:直接用手机的局域网地址,按上面步骤安装并信任本地证书。
  • sslip.io:根据当前 IP 生成域名,无需注册账号。它仍使用本地证书,需要接收设备信任;DNS 解析通常需要互联网。IP 改变后,以 App 显示的新地址为准。
  • DuckDNS:填写专用的 name.duckdns.org 与 Token,点「更新到当前 IP」更新解析。使用外部 ACME 工具申请域名证书,并将含私钥和完整证书链的 P12/PFX 导入 App。App 不自动申请或续期证书;IP 改变后需重新更新解析,证书到期前需重新导入。Token、证书和文件密码保存在本机 Keychain。
域名不建立公网隧道,也不保证绕过特斯拉等车机对局域网访问的限制。DuckDNS 的真实域名、公开证书和车机完整连接尚未验证,不把它写成已适配特斯拉。

选择声音输出

  • 由 iPhone 输出是默认方式。声音走 iPhone 当前选中的扬声器或蓝牙设备,iPhone 连上车机蓝牙时可由车机播放。
  • 随画面传输(Wi-Fi)会让浏览器播放伴音。在「设置 → 声音」选择后重新启动 CarPlay。网页先播放画面,再尝试自动出声。如果浏览器拦截音频自动播放,点「开启声音」即可。通话和 Siri 的声音留在 iPhone。
  • 电脑网页点「全屏」后可按 Esc 退出。点「统计」可以查看解码模式、丢帧和音频缓冲等信息。

画面设置与车辆按钮

  • 跟随车机。 浏览器会报告接收窗口尺寸。多个接收页同时连接时,第一个接收页决定画面规格,其他接收页观看同一视频流。主接收页关闭后,可由剩余接收页接管。
  • 固定尺寸。 如果车机拉伸画面,或遇到黑屏、卡顿,可在「设置 → 画面」试用固定分辨率、30 FPS 和 H.264。配置改变可能需要重启 CarPlay。
  • 车辆按钮。 在「设置 → 车辆」可启用车辆按钮、选取自己的图标,或恢复默认。图标更改在下次启动 CarPlay 时生效。App 全屏时,可从 CarPlay 主屏幕点车辆按钮退出。如果未显示车辆按钮,可以点左上角退出。
  • 画中画与后台。 在设置首页的「后台与画中画」分组选择开启时机,默认为「离开 App 时」,也可选择「出画面后立即」或关闭自动开启。使用锁屏继续运行前,在 iPhone 的「设置 → 通用 → CarPlay → CarWithin」开启「锁定时允许 CarPlay」。画中画只显示实时画面,触控在 App 或浏览器中完成。

Wi-Fi 预设与常用设置

设置顶部提供「使用说明」「Wi-Fi 与网络」「Wi-Fi 预设」「当前输出」和「输出设置」。选择浏览器输出时也可进入「HTTPS 设置」。

在「Wi-Fi 与网络」添加名称、密码等信息,完成后返回即可自动保存;在「Wi-Fi 预设」可编辑当前预设,开放网络可打开无密码选项。同名 Wi-Fi 只保存一项,再次修改密码会更新原预设。切换网络时,在「Wi-Fi 预设」点选即可。左滑删除预设后还需确认,同时删除该网络保存的密码。Wi-Fi 名称和密码输入时不再反复重建设置页面,减少输入卡顿。固定画面尺寸支持选择常见横屏和竖屏比例。

CarPlay 运行中部分连接设置会锁定,停止后再修改。CarPlay 外观、驾驶位和声音在设置首页;日志位于「诊断与实验」,版本与更新入口位于「关于」。

其他输出方式

  • 无线 CarLife。 适用于兼容无线 CarLife 的车机。让车机与 iPhone 连到同一 Wi-Fi,在 CarWithin 选择 CarLife,再打开车机上的 CarLife,最后启动本机 CarPlay。车机 IP 可手动填写,留空时自动发现。画面与触控走 CarLife,声音可以走车机蓝牙。输出最高为 H.264、1080p、30 FPS。
  • AirPlay(实验)。 在输出方式选择 AirPlay,启动 CarPlay 并等待画面就绪。在主界面连接卡片点 AirPlay 图标,选取同一网络中的视频接收器。AirPlay 画面有缓冲,触控仍在 iPhone 上完成,声音沿用 iPhone 或车机蓝牙。

极核 AE4 MAX2+ 6.2 寸仪表

iPhone 加入仪表 Wi-Fi,选择同名预设,在「当前输出」选择「极核 6.2 寸」。打开仪表投屏后启动本机 CarPlay。仪表 IP 默认 192.168.0.1,可在「输出设置」修改。画面为 1024×480 H.264、最高 25 帧,声音由 iPhone 或蓝牙输出,在手机上操作 CarPlay。

一台仪表已确认正常出画及锁屏后继续更新,其他型号、反复锁屏和长时间使用仍需实测。

九号 5 寸仪表

iPhone 加入仪表 Wi-Fi,选择同名 Wi-Fi 预设,在「当前输出」选择「九号 5 寸」。打开仪表投屏后启动本机 CarPlay。仪表 IP 默认为 192.168.1.1,可在「输出设置」修改。声音由 iPhone 或蓝牙输出,触控在手机上操作。

一台仪表已验证正常出画,多次切后台、锁屏后仍继续更新。用户感知延迟约 500–600 毫秒,其他型号仍需实测。

台铃 4.3 寸

目前针对 TL-DASH-V2 仪表,其他型号和固件仍需验证:

  1. iPhone 加入仪表的 Wi-Fi,并在「Wi-Fi 与网络」填写对应名称和密码。
  2. 在「当前输出」选择「台铃 4.3 寸」。仪表 IP 默认为 192.168.1.1,需要时在「输出设置」修改。
  3. 开启仪表投屏,退出其他投屏 App,再在 CarWithin 启动本机 CarPlay。主界面连接卡片会显示状态。
仪表画面固定为 480×272、最高 20 FPS。声音由 iPhone 当前的扬声器或蓝牙设备播放;仪表不回传触控,操作在 iPhone 上完成。此模式会自动使用匹配的画面参数,切回其他输出后恢复原设置。

已在本台仪表确认出画和锁屏后恢复更新。锁屏时解码器可能短暂失效,App 会从关键帧重建并继续投屏,切换时可能短暂停顿。持续长播、反复锁屏、异常断网及其他仪表尚未逐项验证。

检查更新与安装新版

  • 在「关于 → 检查更新」查看最新版说明;当前已是最新版时也可以查看详情和下载。完整发布说明可展开查看,「版本记录」可查看历史发布。
  • App 会在前台空闲时自动检查,成功后间隔 24 小时;失败后 15 分钟再试。发现新版本可选择下载、下次再说或此版本不再提醒。CarPlay 运行期间会延后自动检查,并限制安装包下载。
  • 下载完成并校验后弹出系统分享菜单,可交给兼容的签名工具打开,也可以保存到自己选择的文件夹。签名和安装仍需在相应工具中完成,App 不会自行安装 IPA。
  • 从 1.0.0 升级时,旧版检查更新会先打开 GitHub 发布页,需要自行下载并签名安装;安装新版后才有上述 App 内下载与分享流程。

常见问题

  • 一直停在正在连接 CarPlay。 等待超过约 5 秒后,App 会显示小字提示。可尝试关闭再打开 iPhone 的 Wi-Fi,并确认网络信息正确;该提示不会打断当前启动。
  • 网页打不开。 确认 CarPlay 已启动、局域网接收页已打开、两台设备能互访,并用 App 显示的 HTTP 地址先试。能开 HTTP、HTTPS 提示证书问题时,按上面的步骤在接收设备上配置证书。
  • 连接成功但不出画面。 试用 H.264、较低的分辨率或帧率,也可换浏览器。Redmi K30 5G 的 X 浏览器已实测能播放 HTTP 和 HTTPS。同机的 Chrome 109 曾遇到 H.265 解码失败。若切换网页后出现硬解码器资源不足,重启浏览器再试。
  • 网页有画面但没声音。 检查是否已选「随画面传输(Wi-Fi)」并重新启动 CarPlay。若网页显示「开启声音」,点一下,再检查接收设备的音量。
  • 如何查版本或反馈问题。 在「设置 → 关于」查看版本、检查更新或查看发布记录。反馈问题时请附 iPhone 和接收设备型号、系统、浏览器版本、HTTP/HTTPS、编码和分辨率,以及「设置 → 诊断与实验 → 日志」中相关片段。 提交问题

工作原理与许可

iPhone 通过虚拟配件与本机接收端建立 CarPlay 会话。CarWithin 接收 iOS 生成的画面和声音,并把触控传回系统。开启网页输出后,视频通过 WebSocket 送到接收设备,兼容模式用 MSE,支持时可用 WebCodecs 逐帧解码。

CarWithin 基于 tds-car-kit,完整组合程序按 AGPL-3.0-only 分发。原有 GPL-3.0-or-later 代码及第三方组件保留各自许可,详见 LICENSE 和 THIRD_PARTY_NOTICES.txt。CarLife 实现移植自 OpenXPlay-Stream,采用 AGPL-3.0-only。协议实现参考了 PlayPort、DiPlay 与 xcertplay,并使用 MIT 许可的 BigInt。CarWithin 与 Apple 无官方关联。

作者与支持

Copyright © 2026 xmz28
Chat with me