ブラウザー

サンプルを参照する

この記事では、.NET マルチプラットフォーム アプリ UI (.NET MAUI) IBrowser インターフェイスを使用する方法について説明します。 このインターフェイスにより、アプリケーションはシステム優先ブラウザーまたは外部ブラウザーで Web リンクを開くことができます。

IBrowser インターフェイスの既定の実装は、Browser.Default プロパティを通じて使用できます。 IBrowser インターフェイスと Browser クラスは、どちらも Microsoft.Maui.ApplicationModel 名前空間に含まれています。

作業の開始

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

<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>

ブラウザーを開く

ブラウザーは、Uri と BrowserLaunchMode 型で IBrowser.OpenAsync メソッド呼び出して開きます。 次のコード例は、ブラウザーを開く方法を示しています。

private async void BrowserOpen_Clicked(object sender, EventArgs e)
{
    try
    {
        Uri uri = new Uri("https://www.microsoft.com");
        await Browser.Default.OpenAsync(uri, BrowserLaunchMode.SystemPreferred);
    }
    catch (Exception ex)
    {
        // An unexpected error occurred. No browser may be installed on the device.
    }
}

このメソッドは、ユーザーがブラウザーを閉じた後ではなく、ブラウザーが起動された後に返されます。 Browser.OpenAsync は、ブラウザーが正常に起動されたかどうかを示す bool 値を返します。

カスタマイズ

システム優先ブラウザーを使用している場合、iOS と Android で使用できるカスタマイズ オプションがいくつかあります。 これらのオプションには、TitleMode (Android のみ) と、Toolbar (iOS と Android)、Controls (iOS のみ) で表示される優先色が含まれます。

これらのオプションは、OpenAsync の呼び出し時に BrowserLaunchOptions を使用して指定します。

private async void BrowserCustomOpen_Clicked(object sender, EventArgs e)
{
    try
    {
        Uri uri = new Uri("https://www.microsoft.com");
        BrowserLaunchOptions options = new BrowserLaunchOptions()
        {
            LaunchMode = BrowserLaunchMode.SystemPreferred,
            TitleMode = BrowserTitleMode.Show,
            PreferredToolbarColor = Colors.Violet,
            PreferredControlColor = Colors.SandyBrown
        };

        await Browser.Default.OpenAsync(uri, options);
    }
    catch (Exception ex)
    {
        // An unexpected error occurred. No browser may be installed on the device.
    }
}

プラットフォームによる違い

このセクションでは、ブラウザー API とのプラットフォーム固有の違いについて説明します。