Xamarin.Forms 雙螢幕

Microsoft Surface Duo 之類的雙螢幕裝置可協助您的應用程式提供新的用戶體驗可能性。 Xamarin.Forms 包含 TwoPaneViewDualScreenInfo 類別,讓您可以開發雙螢幕裝置的應用程式。

開始使用

請遵循下列步驟,將雙螢幕功能新增至 Xamarin.Forms 應用程式:

  1. 開啟解決方案的 [NuGet 封裝管理員] 對話框。

  2. 在 [瀏覽] 索引標籤底下搜尋 Xamarin.Forms.DualScreen

  3. Xamarin.Forms.DualScreen 套件安裝到您的解決方案。

  4. 在事件中OnCreate,將下列初始化方法呼叫新增至 Android 專案的 MainActivity 類別:

    Xamarin.Forms.DualScreen.DualScreenService.Init(this);
    

    應用程式必須有這個方法,才能偵測應用程式狀態的變更,例如跨越兩個畫面。

  5. Activity更新 Android 項目MainActivity類別上的 屬性,使其包含下列ConfigurationChanges所有選項:

    ConfigurationChanges = ConfigChanges.ScreenSize | ConfigChanges.Orientation
        | ConfigChanges.ScreenLayout | ConfigChanges.SmallestScreenSize | ConfigChanges.UiMode
    

    這些值是必要的,因此可以更可靠地報告組態變更和範圍狀態。 根據預設,只有兩個新增至 Xamarin.Forms 專案,因此請記得新增其餘專案以取得可靠的雙屏幕支援。

疑難排解

DualScreenInfo如果類別或TwoPaneView版面配置未如預期般運作,請仔細檢查此頁面上的設定指示。 省略或錯誤設定 Init 方法或 ConfigurationChanges 屬性值是錯誤的常見原因。

如需 Xamarin.Forms 其他指引和參考實作,請檢閱雙螢幕範例

下一步

新增 NuGet 之後,請使用下列指引,將雙螢幕功能新增至您的應用程式:

如需詳細資訊, 請瀏覽雙螢幕開發人員檔