Cada declaração é projetada com um consumidor em mente. A declaração de consumidor é aquela que lê e verifica uma declaração feita por um diretor e, em seguida, toma medidas com base nessa declaração. Mais especificamente, um consumidor executa estas etapas básicas:
- Solicitar a lista de instruções de um principal específico
- Verifique se a lista contém uma declaração específica em relação a um determinado destino.
- Valide se o alvo na declaração é o alvo (site ou app) que você acha que é
- Executa a ação especificada pela instrução, se você optar por
Muitos casos de uso consomem instruções para você em segundo plano. Por exemplo, a Vinculação de apps Android consome declarações de permissão de links feitas por um site para ativar links diretamente nele. Um app indica que concorda em ser um alvo dessas instruções adicionando um código especial (um gerenciador de intent) ao manifesto.
Você pode executar as etapas 1 e 2 acima (solicitar e validar uma instrução) de duas maneiras: usando nossa API ou manualmente (usando sua própria implementação).
Como consumir instruções usando a API Digital Asset Links
A API Digital Asset Links é compatível com dois métodos, Check() e List(), para encontrar ou validar instruções:
Check()usa uma origem, um destino e uma relação e verifica se a fonte faz a instrução enviada sobre o destino.List()lista todas as instruções feitas por uma determinada fonte.
Como consumir instruções manualmente
O protocolo Digital Asset Links está aberto, então você pode criar uma implementação dele.
Para consumir instruções feitas por sites, faça uma solicitação HTTP GET para a lista de instruções correspondente e a analise por conta própria. Por exemplo, a lista de instruções correspondente para o site http://example.digitalassetlinks.org está em http://example.digitalassetlinks.org/.well-known/assetlinks.json.
Para consumir instruções feitas por apps Android, você precisa acessar o manifesto do pacote APK correspondente. Em dispositivos Android, isso pode ser feito usando a interface PackageManager.
Preste atenção especial aos significados específicos das instruções Digital Asset Links. Consulte a Especificação de links de recursos se não tiver certeza.