Xamarin.Essentials:ブラウザーXamarin.Essentials: Browser

Browser クラスを使用すると、最適化されたシステム推奨のブラウザーまたは外部のブラウザーを使って、アプリケーションで Web リンクを開くことができます。The Browser class enables an application to open a web link in the optimized system preferred browser or the external browser.

作業開始Get started

この API の使用を始めるには、Xamarin.Essentials の概要ガイドを読み、ライブラリが正しくインストールされてプロジェクトに設定されていることを確認してください。To start using this API, read the getting started guide for Xamarin.Essentials to ensure the library is properly installed and set up in your projects.

ブラウザーの使用Using Browser

自分のクラスの Xamarin.Essentials に参照を追加します。Add a reference to Xamarin.Essentials in your class:

using Xamarin.Essentials;

ブラウザー機能を動作させるには、UriBrowserLaunchMode と共に OpenAsync メソッドを呼び出します。The Browser functionality works by calling the OpenAsync method with the Uri and BrowserLaunchMode.


public class BrowserTest
{
    public async Task<bool> OpenBrowser(Uri uri)
    {
        return await Browser.OpenAsync(uri, BrowserLaunchMode.SystemPreferred);
    }
}

このメソッドは、ブラウザーが_起動_した後に返されるもので、必ずしもブラウザーがユーザーによって_終了_されるわけではありません。This method returns after the browser was launched and not necessarily closed by the user. bool の結果は起動が成功したかどうかを示しています。The bool result indicates whether the launching was successful or not.

カスタマイズCustomization

システム推奨ブラウザーの使用時、iOS と Android ではカスタマイズ オプションをいくつか利用できます。When using the system preferred browser there are several customization options available for iOS and Android. たとえば、TitleMode (Android のみ)、Toolbar に推奨される色の選択肢 (iOS と Android)、Controls の表示 (iOS のみ) があります。This includes a TitleMode (Android only), and preferred color options for the Toolbar (iOS and Android) and Controls (iOS only) that appear.

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

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

ブラウザー オプション

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

起動モードによってブラウザーを起動する方法が決定されます。The Launch Mode determines how the browser is launched:

システム推奨System Preferred

Chrome Custom Tabs を使用して URI を読み込み、ナビゲーション認識を保持することが試みられます。Chrome Custom Tabs will attempted to be used load the Uri and keep navigation awareness.

外部External

Intent を使用して、システムの通常のブラウザーで URI を開くよう要求します。An Intent will be used to request the Uri be opened through the systems normal browser.

APIAPI

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