SuperAPI AI 工具集

carplay

编程与开发

查看项目

更新于 10-15 21:12

技能介绍

用途:指导使用 CarPlay 框架构建基于模板、需类别授权的车载显示应用,适用于导航、音频、通信、电动车充电、停车、快速订餐等类别。范围标注为 Swift 6.3、iOS 26+。

主要能力:说明各类别对应的授权键(如 com.apple.developer.carplay-audio、carplay-communication、carplay-maps、carplay-charging、carplay-parking、carplay-quick-ordering)及申请与工程配置流程;讲解 CPTemplateApplicationScene、CPTemplateApplicationSceneDelegate、CPInterfaceController、CPTemplate、CPSessionConfiguration 等关键类型;介绍通用模板(CPTabBarTemplate、CPListTemplate、CPGridTemplate、CPInformationTemplate、CPAlertTemplate、CPActionSheetTemplate)与类别专属模板(CPMapTemplate、CPSearchTemplate、CPNowPlayingTemplate、CPPointOfInterestTemplate、CPContactTemplate);并给出导航会话、路线选择、地图按钮、搜索、Now Playing、消息列表、兴趣点等用法要点。

使用方式:在 Info.plist 声明 CarPlay 场景,实现场景代理;导航类应用需实现带 CPWindow 的 didConnect 方法并将地图内容设为窗口根视图,根模板须为 CPMapTemplate;非导航应用仅获得接口控制器。用 setRootTemplate、pushTemplate、presentTemplate、popTemplate 管理模板层级。可在 Xcode 模拟器通过 I/O > External Displays > CarPlay 测试,默认 800x480 @2x,导航可启用额外选项:defaults write com.apple.iphonesimulator CarPlayExtraOptions -bool YES。

限制:模拟器无法测试锁屏 iPhone 行为、Siri、与车载收音机音频共存及物理输入硬件;CPTabBarTemplate 只能作根模板;CPNowPlayingTemplate 须用 shared;CPMessageListItem 由 Siri 管理,不应设置自定义 handler;CPWindow 仅用于地图内容;需遵守列表最大条目与分区限制。CarPlay 可见的 WidgetKit 小组件与 ActivityKit 实时活动属独立系统体验,不在本技能范围。更多扩展模式见 references/carplay-patterns.md。