Partilhar via

Iniciar o aplicativo padrão para um URI

  • Artigo

APIs importantes

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:

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

Esquema de URI Lançamentos
bingmaps:, ms-drive-to:, and ms-walk-to: Aplicativo Mapas
http: e https: Navegador da Web padrão
mailto: Aplicativo de email padrão
microsoft-edge: Navegador Microsoft Edge
ms-call: Aplicativo de chamada
ms-chat: Aplicativo de mensagens
ms-people: Aplicativo Pessoas
ms-photos: Aplicativo fotos
ms-recall: Clique para executar (parte do Recall )
ms-settings: Aplicativo de configurações
ms-store: Aplicativo da Store
ms-tonepicker: Seletor de tons
ms-yellowpage: Aplicativo Números Próximos
msnweather: Aplicativo meteorológico

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 mais informações, consulte Recomendar um aplicativo caso não haja um disponível para gerenciar o URI.

Em geral, seu aplicativo não pode selecionar o aplicativo que é iniciado. 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 Recomendar um aplicativo se nenhum estiver disponível para lidar com URI.

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. Se você tentar iniciar um URI e seu aplicativo não estiver em primeiro plano, a inicialização falhará e seu retorno de chamada de erro será invocado.

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 uriBing = new Uri(@"http://www.bing.com");

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

   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.

uma caixa de diálogo de aviso sobreposta em um plano de fundo esmaecido do aplicativo. A caixa de diálogo pergunta ao usuário se ele deseja trocar de aplicativo e tem botões

Se você sempre quiser que esse prompt ocorra, use a propriedade Windows.System.LauncherOptions.TreatAsUntrusted para informar o sistema operacional de que deve 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();
promptOptions.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 dar ao usuário uma recomendação específica quanto a qual aplicativo adquirir nesse cenário, poderá fazê-lo passando essa recomendação com o URI que você está iniciando.

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();
options.PreferredApplicationPackageFamilyName = "Contoso.URIApp_8wknc82po1e";
options.PreferredApplicationDisplayName = "Contoso URI Ap";

// 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 que permaneçam na tela após uma inicialização de 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 o 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.

Observação o Windows leva em conta vários fatores diferentes quando determina o tamanho final da janela do aplicativo de origem, por exemplo, a preferência do aplicativo de origem, o número de aplicativos na tela, a orientação da tela e assim por diante. Ao definir DesiredRemainingView, não é garantido um comportamento de janela específico para o aplicativo de origem.

// Set the desired remaining view.
var options = new Windows.System.LauncherOptions();
options.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 abaixo.

Esquema de URI do aplicativo de chamada

Use o esquema de URI ms-call: para iniciar o aplicativo de chamada.

Esquema de URI Resultado
ms-call:settings Chama a página de configurações do aplicativo.

Esquema de URI de email

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

Esquema de URI Resultados
mailto: Inicia o aplicativo de email padrão.
mailto:\[email address\] Inicia o aplicativo de email e cria uma nova mensagem com o endereço de email especificado na linha Para. Observe que o email não é enviado até que o usuário toque no envio.

Esquema de URI HTTP

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

Esquema de URI Resultados
http: Inicia 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 Mapas do Windows em mapas, direções e resultados da busca 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

um exemplo do aplicativo de mapas do Windows.

Para saber mais, consulte Iniciar o aplicativo Mapas do Windows. Para usar o controle de mapeamento no seu próprio aplicativo, consulte Display maps with 2D, 3D, and Streetside views.

Esquema de URI do aplicativo de mensagens

Use o esquema URI ms-chat: para abrir o app de Mensagens do Windows.

Esquema de URI Resultados
ms-chat: Inicia o aplicativo de mensagens.
ms-chat:?ContactID={contacted} Permite que o aplicativo de mensagens seja iniciado com informações de um contato específico.
ms-chat:?Body={body} Permite que o aplicativo de mensagens seja iniciado com uma cadeia de caracteres a ser usada como o conteúdo da mensagem.
ms-chat:?Addresses={address}&Body={body} Permite que o aplicativo de mensagens seja iniciado com as informações de um endereço específico e com uma cadeia de caracteres a ser usada como o conteúdo da mensagem. Observação: os endereços podem ser concatenados.
ms-chat:?TransportId={transportId} Permite que o aplicativo de mensagens seja iniciado com uma ID de transporte específica.

Esquema de URI de seletor de tom

Use o esquema de URI ms-tonepicker: para escolher toques, alarmes e sons do sistema. Você também pode salvar novos toques e obter o nome de exibição de um tom.

Esquema de URI Resultados
ms-tonepicker: Escolha toques de chamada, alarmes e tons do sistema.

Os parâmetros são passados por meio de um ValueSet para a API LaunchURI. Consulte Escolher e salvar tons usando o esquema de URI ms-tonepicker para obter detalhes.

Esquema de URI do aplicativo Números Próximos

Use o esquema de URI ms-yellowpage: para iniciar o aplicativo Nearby Numbers.

Esquema de URI Resultados
ms-yellowpage:?input=\[keyword\]&method=\[String or T9\] Inicia o app Nearby Numbers.
input refere-se à palavra-chave que você deseja pesquisar.
method refere-se ao tipo de pesquisa (cadeia de caracteres ou pesquisa T9).
Se method é T9 (um tipo de teclado), então keyword deve ser uma sequência numérica que mapeia para as letras de teclado T9 para pesquisar.
Se method é String, então keyword é a palavra-chave a ser pesquisada.

Esquema de URI do aplicativo Pessoas

Utilize o esquema de URI ms-people: para iniciar o aplicativo Pessoas. Para saber mais, consulte Iniciar o app 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:
Para exibir uma imagem: ms-photos:viewer?fileName=c:\users\userName\Pictures\image.jpg
Ou editar um vídeo: ms-photos:videoedit?InputToken=123abc&Action=Trim&StartTime=01:02:03

Nota

As URIs para editar um vídeo ou exibir uma imagem só estão disponíveis na área de trabalho.

Esquema de URI Resultados
ms-photos:viewer?fileName={filename} Inicia o aplicativo Fotos para exibir a imagem especificada em que {filename} é um nome de caminho totalmente qualificado. Por exemplo: c:\users\userName\Pictures\ImageToView.jpg
ms-photos:videoedit?InputToken={input token} Inicia o aplicativo Fotos no modo de edição de vídeo para o arquivo representado pelo token de arquivo. InputToken é necessário. Use o SharedStorageAccessManager para obter um token para um arquivo.
ms-photos:videoedit?Action={action} Um parâmetro que indica em qual modo de edição de vídeo abrir o aplicativo Fotos, em que {action} é um dos: SlowMotion, FrameExtraction, Trim, View, Ink. Action é necessária.
ms-photos:videoedit?StartTime={timespan} Um parâmetro opcional que especifica onde começar a reproduzir o vídeo. {timespan} deve estar no formato "hh:mm:ss.ffff". Se não for especificado, o padrão será 00:00:00.0000

Esquema de URI de aplicativo de configurações

Use o esquema de URI ms-settings: para iniciar o aplicativo Configurações do Windows. O acesso ao aplicativo Configurações é uma parte importante da escrita de um aplicativo consciente da 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 o aplicativo Configurações e exibe as configurações de privacidade da câmera.

ms-settings:privacy-webcam

configurações de privacidade da câmera.

Para obter mais informações, consulte Iniciar o app Configurações do Windows e Diretrizes para aplicativos com reconhecimento de privacidade.

Esquema de URI do aplicativo Store

Use o esquema de URI ms-windows-store: para iniciar o aplicativo UWP. 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 UWP e inicia a home page da Loja.

ms-windows-store://home/

Para obter mais informações, consulte Iniciar o aplicativo UWP.

Esquema de URI do aplicativo meteorológico

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

Esquema de URI Resultados
msnweather://forecast?la=\[latitude\]&lo=\[longitude\] Inicia o aplicativo Clima na página Previsão com base em coordenadas geográficas de localização.
latitude refere-se à latitude da localização.
longitude refere-se à longitude da localização.

Esquema de URI do Microsoft Edge

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

Esquema de URI Resultados
microsoft-edge:https://example.com/ Abre o navegador Microsoft Edge e navega até https://example.com/