iPhone Duo 教學會 QA 整理

全螢幕遊戲如何適配 iPhone Duo？

建議移除 UIRequiresFullScreen。保留這個 key 仍可在 Duo 上運行，但部分姿態可能以固定比例橫屏渲染並出現黑邊。移除後，可用額外空間鋪素材或移動主遊戲區；同時要讓操作區避開攝像頭、狀態列等系統區域，使用陀螺儀的操作也需依姿態調整。

第三方遊戲引擎與跨平台框架有何方案？

Reserve Region 等公開 API 歡迎遊戲引擎廠商接入、共同推進支援。若使用 Flutter 或其他第三方引擎，適配需依賴引擎本身的支援；官方較建議採用原生方式。

Landscape only 的 App，為何在 Duo 完全展開後會變成豎屏？

外屏會遵循 Orientation 設定，但內屏不支援固定方向，App 可能隨不同方向旋轉。因此必須做好多種視窗尺寸的適配。

如何針對帳篷姿態（Tent Mode）或半折疊姿態調整 App 內體驗？

沒有 API 能直接告知目前是否為帳篷姿態。應優先依 Size Class 與自身佈局適配，必要時再以鉸鏈狀態輔助判斷。

半折疊狀態有哪些典型情境？如何避免點擊不便？

典型情境包括書本式閱讀、筆記本式放在桌上看影片，以及雙 App 使用時略微張開。互動元件應盡量避開中央折疊區域。

展開時分屏顯示兩個 App，合攏後會如何處理？

外屏只會顯示一個 App，由系統決定顯示哪一個。

模擬器如何開啟 Standby Mode？

目前 Duo 模擬器不支援 Standby Mode；需求急迫可提交 Feedback Assistant。Standby 屬於 App 外體驗，應以 WidgetKit、即時動態與 AlarmKit 實作。

如何做到演示中的床頭鐘與鬧鐘光暈？

要做到演示中的 App 外鬧鐘效果，需要使用 AlarmKit。

數百個頁面、舊架構的大型 App，應如何開始適配？

採漸進策略，具體路徑依團隊與產品特性決定。建議先採用新的設計語言、處理頂 bar 與底 bar 的縱向切換，並優先完成一級頁與關鍵路徑，深層頁面再逐步規劃。可先嘗試 app resizability，讓舊專案具備在 Duo 運行的基本能力。App Store 審核相關問題未在本場回答。

已完成 iPad 自由尺寸適配，可以直接套用到 iPhone Duo 嗎？

不能直接視為相同策略。Duo 的設計與技術適配仍以 iPhone 情境為核心。內容瀏覽或生產力情境在內屏展開時可接近 iPad 思路，但導航、Tab Bar 與 Toolbar 不建議照搬 iPad 做法。

iPad 的 Split Navigation Stack 可以套用到 iPhone Duo 嗎？

可以。若 iPad 已用 Split Navigation Stack 實作「列表加 detail」，可直接延伸到 Duo 展開橫屏。Arrangement View 的用途不同，不能拿來做導航。

iPhone Duo 的多窗口和 iPad 一樣嗎？

對 App 而言能力與 iPad 相同，差異只在系統操作方式。已支援 iPad 多窗口的 App，應立即在 Duo 模擬器測試。

自訂導航欄、工具欄或 Tab Bar 如何適配？

使用系統導航容器時，系統會自動調整佈局，也有 API 協助把自訂頂欄或底欄移到側邊欄。完全自訂的欄項，需監聽 Trait Collection 的 Vertical Bar Edge，依欄位轉為縱向後的方向與位置重新佈局。

自訂導航列在 Duo 上應如何適配？

優先使用原生導航列與元件。若必須自訂，返回按鈕應依 Duo 規則放到側邊欄，並以 Trait Collection 的 UI Vertical Bar Edge 與新增的 Bar Layout Guide 調整位置。

自訂導航列、標題與靈動島區域如何避免重疊？

使用 Reserved Region 取得系統保留區域，避開狀態列與攝像頭硬體區域。靈動島可能長時間存在，應持續觀察 Reserved Region 的尺寸變化。

Tab Bar 是否只有一級頁需要避讓右側 safe area？

不是。只要以 Tab Bar 作為一級導航，後續深層頁面也都應讓 Tab Bar 常駐，並持續避讓右側空間。

Tab Bar 能否固定在底部、不移到側邊？

技術上可用 Toolbar Vertical Behavior 停用縱向模式；但除了全螢幕或特殊需求，建議遵循系統預設佈局。

ArrangementView 只適用 iPhone Duo 嗎？

不是。它自 iOS 與 iPadOS 27.1 起可用於所有機型，在 Duo 部分折疊時另有自動避開鉸鏈的優化。它的兩欄佈局在外屏會自然呈現單欄，不需指定只供內屏使用。

閱讀類 App 展開後採上下捲動，文字應如何排版？

建議兩側保留固定留白，中央閱讀區維持固定或最大寬度，並考慮使用 readableContentGuide，避開螢幕圓角等不利閱讀的區域。

safe area 內的內容應如何排版？

內容建議始終放在 safe area 內。外屏右側與底側有 safe area insets，左側有 default layout margin，可作為內邊距參考，再依實際需求調整。

既有的外接螢幕功能，在 iOS 27 需要更新嗎？

既有功能即為相同能力。若使用 Xcode 27 開發，需額外適配 UI Sync Accessory API，否則系統無法提供新的 Sync；以 Xcode 26 建置並在 iOS 27 運行則不受影響。

內外屏能否同時顯示不同的 view？

目前唯一途徑是 camera capture accessory，而且必須是相機 App 在內屏顯示相機場景。其他明確需求可提交 Feedback。

如何取得 App Resizability Skills？

這個 Skills 內建於 Xcode 27.1，可透過 xcrun Agent Skills Export 匯出。

模擬器能否測試鉸鏈 API？

可以。Device Hub 可切換折疊、半展開與完全展開等離散狀態；按住 Option 操作相關按鈕會轉為滑桿，可測試連續角度變化。

模擬器足以測試真機顯示與攝像頭嗎？

Xcode 27.1 的 Duo 模擬器對 UI 佈局有很高保真度，但完整攝像頭功能與效能仍需真機。前期可用虛擬前置攝像頭簡化開發。