Comissionamento do SDK Home Mobile

Nesta página, abordamos o uso de alguns recursos da API de comissionamento na Google Home Mobile SDK.

Suprimir notificações de descoberta comissionadas

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

Por padrão, Google Play services em Android usa notificações de "meia-folha" 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 ficar 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 ver mais informações.

Indicar suporte para comissionamento do Matter

Se você estiver usando o Mobile SDK para comissionar, vai ser necessário adicionar o nome do pacote do app no Google Home Developer Console, implementar nossas APIs Matter e indicar que o app oferece suporte ao comissionamento de 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 app de exemplo para referência.

Seletor de apps

Seletor de apps

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

  1. Na tela Escolher um app.
  2. Se o usuário selecionar Escolher outro app, ele será exibido na tela Outros apps instalados.

Apps sugeridos

O seletor exibe dois apps sugeridos.

  • A primeira é sempre Google Home app (GHA).
  • A segunda é 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

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

  1. Instalado: Play services verifique se o aplicativo oferece suporte ao filtro de intent ACTION_COMMISSION_DEVICE. Se o filtro de intent estiver ausente, o usuário será direcionado à Play Store para atualizar o app.
  2. Not Installed: o usuário é direcionado à Play Store para instalar o app antes de continuar.