Comissionamento do SDK Home Mobile

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

Suprimir notificações de descoberta comissionadas

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

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

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 metade da planilha serão começar 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 comissionamento do Matter

Se você estiver usando o Mobile SDK para a comissão, será necessário adicione o nome do pacote do app no Google Home Developer Console, implemente as Matter APIs e indicar que o app oferece suporte a Matter comissionamento 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 nossa manifesto do app de exemplo como referência.

Seletor de apps

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

1. Na tela Escolher um app,
2. Se os usuários selecionarem Escolher outro aplicativo, isso será exibido na coluna Outros aplicativos Tela Apps.

Apps sugeridos

O seletor mostra dois apps sugeridos.

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

Existem dois cenários quando os apps aparecem na tela Escolha um app.

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