Nesta página, abordamos o uso de alguns recursos da API de comissionamento na Google Home Mobile SDK.
Suprimir notificações de descoberta comissionadas
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
Existem duas maneiras de o app aparecer no seletor de apps durante o processo de comissionamento:
- Na tela Escolher um app.
- 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.
Há dois cenários em que os apps estão na tela Escolher um app.
- 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. - Not Installed: o usuário é direcionado à Play Store para instalar o app antes de continuar.