Iniciar o aplicativo padrão do Windows para um URI

Saiba como iniciar o aplicativo padrão para um URI (Uniform Resource Identifier). As URIs permitem que você inicie outro aplicativo para executar uma tarefa específica. Este tópico também fornece uma visão geral dos muitos esquemas de URI integrados ao Windows. Você também pode iniciar URIs personalizadas. Para obter mais informações sobre como registrar um esquema de URI personalizado e lidar com a ativação de URI, consulte Manipular a ativação do URI.

Os esquemas de URI permitem que você abra aplicativos clicando em hiperlinks. Assim como você pode iniciar um novo email usando mailto:, você pode abrir o navegador da Web padrão usando http: ou https:.

Este tópico descreve os seguintes esquemas de URI integrados ao Windows:

Por exemplo, o URI a seguir abre o navegador padrão e exibe o site do Microsoft Bing: https://bing.com/.

Você também pode iniciar esquemas de URI personalizados. Se não houver nenhum aplicativo instalado para lidar com esse URI, você poderá recomendar um aplicativo para o usuário instalar. Para obter mais informações, consulte Recomendação de um aplicativo se não houver um disponível para lidar com o URI.

Em geral, seu aplicativo não pode selecionar o aplicativo que será aberto. O usuário determina qual aplicativo é iniciado. Mais de um aplicativo pode se registrar para lidar com o mesmo esquema de URI. A exceção a isso é para esquemas de URI reservados. Os registros de esquemas de URI reservados são ignorados. Para obter a lista completa de esquemas de URI reservados, consulte Manipular a ativação do URI. Nos casos em que mais de um aplicativo pode ter registrado o mesmo esquema de URI, seu aplicativo pode recomendar que um aplicativo específico seja iniciado. Para obter mais informações, consulte Recomendação de um aplicativo se não houver um disponível para lidar com o URI.

APIs importantes

As seguintes APIs do WinRT (Windows Runtime) são usadas neste tópico:

• LaunchUriAsync
• PreferredApplicationPackageFamilyName
• VistaRestanteDesejada

Observe que muitas APIs do WinRT funcionarão com outros aplicativos da área de trabalho com a identidade do pacote. Há algumas exceções e a maioria delas está relacionada a APIs específicas à renderização ou entrada da interface do usuário. Alguns dos LauncherOptions, como TreatAsUntrusted, funcionam apenas em aplicativos UWP. Para ler mais sobre como habilitar seu aplicativo da área de trabalho para trabalhar com APIs do WinRT, consulte Chamar APIs do Windows Runtime em aplicativos da área de trabalho.

Chamar LaunchUriAsync para abrir um URI

Use o método LaunchUriAsync para iniciar um URI. Quando você chama esse método, seu aplicativo deve ser o aplicativo em primeiro plano, ou seja, ele deve estar visível para o usuário. Esse requisito ajuda a garantir que o usuário permaneça no controle. Para atender a esse requisito, certifique-se de vincular todas as inicializações de URI diretamente à interface do usuário do seu aplicativo. O usuário sempre deve executar alguma ação para iniciar uma inicialização de URI. Em um aplicativo UWP, se você tentar abrir um URI e seu aplicativo não estiver em destaque, o lançamento falhará e sua função de erro será invocada.

Primeiro, crie um objeto System.Uri para representar o URI e, em seguida, passe-o para o método LaunchUriAsync . Use o resultado de retorno para ver se a chamada foi bem-sucedida, conforme mostrado no exemplo a seguir.

private async void launchURI_Click(object sender, RoutedEventArgs e)
{
   // The URI to launch
   var bingUri = new Uri(@"https://www.bing.com");

   // Launch the URI
   var success = await Windows.System.Launcher.LaunchUriAsync(bingUri);

   if (success)
   {
      // URI launched
   }
   else
   {
      // URI launch failed
   }
}

Em alguns casos, o sistema operacional solicitará que o usuário veja se realmente deseja mudar de aplicativo.

Se o aplicativo for um aplicativo UWP e você sempre quiser que esse prompt ocorra, use a propriedade Windows.System.LauncherOptions.TreatAsUntrusted a fim de instruir o sistema operacional a exibir um aviso.

// The URI to launch
var uriBing = new Uri(@"http://www.bing.com");

// Set the option to show a warning
var promptOptions = new Windows.System.LauncherOptions
{
   TreatAsUntrusted = true
};

// Launch the URI
var success = await Windows.System.Launcher.LaunchUriAsync(uriBing, promptOptions);

Recomendar um aplicativo se um não estiver disponível para manipular o URI

Em alguns casos, o usuário pode não ter um aplicativo instalado para lidar com o URI que você está iniciando. Por padrão, o sistema operacional lida com esses casos fornecendo ao usuário um link para pesquisar um aplicativo apropriado na loja. Se você quiser fornecer ao usuário uma recomendação específica de qual aplicativo obter nesse cenário, poderá fazer isso passando essa recomendação junto com o URI que você está lançando.

Recomendações também são úteis quando mais de um aplicativo se registrou para lidar com um esquema de URI. Ao recomendar um aplicativo específico, o Windows abrirá esse aplicativo se ele já estiver instalado.

Para fazer uma recomendação, chame o método Windows.System.Launcher.LaunchUriAsync(Uri, LauncherOptions) com LauncherOptions.preferredApplicationPackageFamilyName definido como o nome da família de pacotes do aplicativo na loja que você deseja recomendar. O sistema operacional usa essas informações para substituir a opção geral para pesquisar um aplicativo na loja por uma opção específica para adquirir o aplicativo recomendado da loja.

// Set the recommended app
var options = new Windows.System.LauncherOptions
{
    PreferredApplicationPackageFamilyName = "Contoso.URIApp_8wknc82po1e",
    PreferredApplicationDisplayName = "Contoso URI App"
};

// Launch the URI and pass in the recommended app
// in case the user has no apps installed to handle the URI
var success = await Windows.System.Launcher.LaunchUriAsync(uriContoso, options);

Definir preferência de exibição restante

Os aplicativos de origem que chamam LaunchUriAsync podem solicitar permanecer visíveis na tela após o lançamento de um URI. Por padrão, o Windows tenta compartilhar todo o espaço disponível igualmente entre o aplicativo de origem e o aplicativo de destino que manipula o URI. Os aplicativos de origem podem usar a propriedade DesiredRemainingView para indicar ao sistema operacional que preferem que a janela do aplicativo assuma mais ou menos do espaço disponível. DesiredRemainingView também pode ser usado para indicar que o aplicativo de origem não precisa permanecer na tela após a inicialização do URI e pode ser completamente substituído pelo aplicativo de destino. Essa propriedade especifica apenas o tamanho de janela preferencial do aplicativo de chamada. Ele não especifica o comportamento de outros aplicativos que também podem estar na tela ao mesmo tempo.

// Set the desired remaining view.
var options = new Windows.System.LauncherOptions
{
    DesiredRemainingView = Windows.UI.ViewManagement.ViewSizePreference.UseLess
};

// Launch the URI
var success = await Windows.System.Launcher.LaunchUriAsync(uriContoso, options);

Esquemas de URI

Os vários esquemas de URI são descritos nesta seção.

Esquema de URI de email

Use o mailto: esquema de URI para iniciar o aplicativo de email padrão.

Esquema de URI HTTP

Use o http: esquema de URI para iniciar o navegador da Web padrão.

Esquemas de URI do aplicativo Mapas

Use os esquemas de URI bingmaps:, ms-drive-to:e ms-walk-to: para iniciar o aplicativo Windows Mapas em mapas, direções e resultados de pesquisa específicos. Por exemplo, o URI a seguir abre o aplicativo Windows Mapas e exibe um mapa centralizado sobre Nova York.

bingmaps:?cp=40.726966~-74.006076

Para usar o controle de mapa em seu aplicativo UWP, consulte Exibir mapas com exibições 2D, 3D e Streetside. Se você estiver usando o SDK do Aplicativo do Windows 1.5 ou posterior em um aplicativo WinUI ou em outro aplicativo da área de trabalho, poderá usar o MapControl.

Esquema de URI do aplicativo de mensagens

Use o esquema ms-chat: URI para iniciar o aplicativo de Mensagens da Microsoft.

Esquema de URI do Aplicativo Pessoas

Use o ms-people: esquema de URI para iniciar o aplicativo Pessoas. Para mais informações, veja Lançar o aplicativo Pessoas.

Esquema de URI do aplicativo Fotos

Use o ms-photos: esquema de URI para iniciar o aplicativo Fotos para exibir uma imagem ou editar um vídeo. Por exemplo:

A tabela a seguir lista outros esquemas de URI com suporte para o aplicativo Fotos:

Esquema de URI de configurações

Use o esquema ms-settings: URI para iniciar as configurações do Windows. Iniciar configurações do Windows é uma parte importante da escrita de um aplicativo com reconhecimento de privacidade. Se seu aplicativo não puder acessar um recurso confidencial, recomendamos fornecer ao usuário um link conveniente para as configurações de privacidade desse recurso.

Por exemplo, o URI a seguir abre Configurações e exibe as configurações de privacidade da câmera:

ms-settings:privacy-webcam

Para obter mais informações, consulte Iniciar Configurações do Windows e Segurança e identidade.

Esquema de URI de aplicativo da Loja

Use o esquema ms-windows-store: URI para iniciar o aplicativo da Microsoft Store. Abra páginas de detalhes do produto, páginas de revisão de produto e páginas de pesquisa, etc. Por exemplo, o URI a seguir abre o aplicativo da Microsoft Store e inicia a home page da Loja.

ms-windows-store://home/

Para mais informações, consulte Uso de URIs do ms-windows-store.

Esquema de URI do aplicativo meteorológico

Use o msnweather: esquema de URI para iniciar o aplicativo Weather.

Esquema de URI do Microsoft Edge

Use o microsoft-edge: esquema de URI para iniciar o navegador Microsoft Edge em uma URL especificada.

Você pode usar esse esquema de URI para iniciar o navegador Microsoft Edge, independentemente da configuração padrão do navegador do usuário.

Conteúdo relacionado

Gerenciar a ativação de URI

Iniciar configurações do Windows