Nesta página, abordamos o uso de alguns recursos da API de comissionamento no Google Home Mobile SDK.
Suprimir notificações de descoberta comissionadas
Por padrão, o Google Play services em Android usa notificações de "meia página" que cobrem a metade de baixo da tela de um dispositivo móvel para fornecer aos usuários uma indicação proativa de que dispositivos Matter comissionados estão próximos.
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. Para mais informações, consulte a documentação da API.
A supressão ativada por essa API expira se o app fica 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 folha vã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 comissionamento,
adicione o nome do pacote do app
no Google Home Developer Console, implemente nossas APIs Matter
e indique que seu app oferece suporte à comissão de 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 de app de exemplo para referência.
Seletor de apps
Há duas maneiras de o app aparecer no seletor durante o processo de comissionamento:
- Na tela Escolher um app,
- Se os usuários selecionarem Escolher outro app, ele será exibido na tela Outros apps instalados.
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 projeto Developer Console associado ao VID ou PID do dispositivo.
Existem dois cenários quando os apps aparecem na tela Escolha um app.
- Instalado: Play services verifica 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. - Não instalado: o usuário é direcionado à Play Store para instalar o app antes de continuar.