1. Початок роботи Get started
2. Використання класу Browser Using Browser
3. Налаштування Customization
4. Бажаний режим системи System Preferred
5. зовнішня External
6. Бажаний режим системи System Preferred
7. зовнішня External
8. API API

Клас Browser дозволяє додатку відкрити веб-посилання в улюбленому браузері оптимізованої системи або зовнішньому браузері. 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.

Використання класу Browser Using Browser

Додайте в свій клас посилання на Xamarin.Essentials: Add a reference to Xamarin.Essentials in your class:

using Xamarin.Essentials;

Щоб використовувати функції класу Browser, викличте метод OpenAsync з параметрами Uri і BrowserLaunchMode. 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.

Ці параметри задаються за допомогою BrowserLaunchOptions при виклику OpenAsync. 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});

Режим запуску визначає, як запускається браузер: The Launch Mode determines how the browser is launched:

Бажаний режим системи System Preferred

За допомогою призначених для користувача вкладок Chrome буде виконана спроба завантажити 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.

Бажаний режим системи System Preferred

За допомогою SFSafariViewController виконується завантаження Uri зі збереженням навігації. SFSafariViewController is used to load the Uri and keep navigation awareness.

зовнішня External

За допомогою стандартного параметра OpenUrl в головному додатку запускається браузер за замовчуванням за межами програми. The standard OpenUrl on the main application is used to launch the default browser outside of the application.

Завжди буде запускатися браузер, встановлений у користувача за замовчуванням, незалежно від BrowserLaunchMode. The user's default browser will always be launched regardless of the BrowserLaunchMode.

API API

Інші відео про Xamarin см. На Channel 9 і YouTube . Find more Xamarin videos on Channel 9 and YouTube .