Comissionamento do SDK Home Mobile

Nesta página, você verá o uso de alguns recursos da API de comissionamento no Google Home Mobile SDK.

Suprimir notificações de descoberta comissionadas

Notificação do Android Halfsheet
Figura 1: exemplo de uma notificação de meia página do Android

Por padrão, Google Play services em Android usa notificações de "meia-página" que cobrem a metade inferior da tela de um dispositivo móvel para fornecer aos usuários uma indicação proativa de que dispositivos Matter comissionados estão por perto.

Para evitar interrupções enquanto o app estiver em primeiro plano, você pode suprimir essas notificações chamando o método suppressHalfSheetNotification() no Mobile SDK. Consulte a documentação da API para mais informações.

A supressão ativada por essa API expira se o app estiver em primeiro plano por mais de 15 minutos. Para reativar a supressão após um tempo limite, chame suppressHalfSheetNotification() novamente. Caso contrário, as notificações de meia página começarão a aparecer.

Uma implementação dessa API pode ser encontrada no Google Home Sample App for Matter. Consulte HalfSheetSuppressionObserver.kt para mais informações.

Indicar suporte para a comissão do Matter

Se você estiver usando a Mobile SDK para comissionar, será necessário adicionar o nome do pacote do app no Google Home Developer Console, implementar nossas APIs Matter e indicar que o app é compatível com a comissão Matter processando a intent ACTION_COMMISSION_DEVICE.

Adicione o seguinte intent-filter à declaração application no arquivo AndroidManifest.xml:

<intent-filter>
    <action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
</intent-filter>

Consulte nosso manifesto do aplicativo de amostra para referência.

Seletor de aplicativos

Seletor de aplicativos

Há duas maneiras de exibir o app no seletor durante o processo de comissionamento:

  1. Na tela Escolha um aplicativo.
  2. Se os usuários selecionarem Escolher outro app, ela será exibida na tela Outros apps instalados.

Aplicativos sugeridos

O seletor de apps exibe dois apps sugeridos.

  • A primeira é sempre Google Home app (GHA).
  • O segundo é para o app preferido do fabricante do dispositivo, se ele estiver definido em um projeto Developer Console associado ao VID ou PID do dispositivo. App de comissão preferencial do fabricante do dispositivo

Existem dois cenários em que os apps estão na tela Escolha um app.

  1. Instalado: Play services verifica se o aplicativo é compatível com o filtro de intent ACTION_COMMISSION_DEVICE. Se o filtro de intent estiver ausente, o usuário será direcionado para a Play Store para atualizar o aplicativo.
  2. Não instalado: o usuário é direcionado à Play Store para instalar o app antes de continuar.