Xamarin.Essentials:ブラウザー

Browser クラスを使用すると、最適化されたシステム推奨のブラウザーまたは外部のブラウザーを使って、アプリケーションで Web リンクを開くことができます。

作業開始

この API の使用を始めるには、Xamarin.Essentials の概要ガイドを読み、ライブラリが正しくインストールされてプロジェクトに設定されていることを確認してください。

ブラウザー機能にアクセスするには、次のプラットフォーム固有設定が必要です。

<queries>
  <intent>
    <action android:name="android.intent.action.VIEW" />
    <data android:scheme="http"/>
  </intent>
  <intent>
    <action android:name="android.intent.action.VIEW" />
    <data android:scheme="https"/>
  </intent>
</queries>

ブラウザーの使用

クラスの Xamarin.Essentials への参照を追加します。

using Xamarin.Essentials;

ブラウザー機能を動作させるには、Uri、BrowserLaunchMode と共に OpenAsync メソッドを呼び出します。

public class BrowserTest
{
    public async Task OpenBrowser(Uri uri)
    {
        try
        {
            await Browser.OpenAsync(uri, BrowserLaunchMode.SystemPreferred);
        }
        catch(Exception ex)
        {
            // An unexpected error occured. No browser may be installed on the device.
        }
    }
}

このメソッドは、ブラウザーが起動した後に返されるもので、必ずしもブラウザーがユーザーによって終了されるわけではありません。

カスタマイズ

システム推奨ブラウザーの使用時、iOS と Android ではカスタマイズ オプションをいくつか利用できます。 たとえば、TitleMode (Android のみ)、Toolbar に推奨される色の選択肢 (iOS と Android)、Controls の表示 (iOS のみ) があります。

このようなオプションは OpenAsync の呼び出し時、BrowserLaunchOptions を使用することで指定されます。

await Browser.OpenAsync(uri, new BrowserLaunchOptions
                {
                    LaunchMode = BrowserLaunchMode.SystemPreferred,
                    TitleMode = BrowserTitleMode.Show,
                    PreferredToolbarColor = Color.AliceBlue,
                    PreferredControlColor = Color.Violet
                });

プラットフォームの実装の詳細

API

• Browser のソース コード
• Browser API ドキュメント

関連ビデオ

他の Xamarin ビデオは、Channel 9 および YouTube でご覧いただけます。