Comissionamento do SDK Home Mobile

Nesta página, abordamos o uso de recursos selecionados da API Commissioning no Google Home Mobile SDK.

Suprimir notificações de descoberta comissionáveis

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

Por padrão, o Google Play services no 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 os dispositivos Matter comissionáveis estão por perto.

Para evitar interrupções enquanto o app está em primeiro plano, suprima 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 vão começar a aparecer.

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

Indicar suporte para o comissionamento do Matter

Se você estiver usando o Mobile SDK para comissionamento, 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 o comissionamento Matter processando a intent ACTION_COMMISSION_DEVICE.

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

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

Consulte o manifesto do nosso app de exemplo para referência.

Seletor de apps

Seletor de apps

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

  1. Na tela Escolher um app.
  2. Se os usuários selecionarem Escolher outro app, ele vai aparecer na tela Outros apps instalados.

Apps sugeridos

O seletor de apps mostra duas sugestões.

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

Há dois cenários em que os apps aparecem na tela Escolher 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 à Google Play Store para atualizar o app.
  2. Não instalado: o usuário é direcionado à Google Play Store para instalar o app antes de continuar.