Verificar a disponibilidade do VPS no local atual do dispositivo

A API Geospatial usa uma combinação de VPS e dados de GPS para gerar poses geoespaciais de alta precisão. A API pode ser usada em qualquer lugar onde o dispositivo possa determinar a própria localização:

• Em áreas com baixa precisão do GPS, como espaços internos e ambientes urbanos densos, a API vai depender da cobertura do VPS para gerar poses de alta precisão.
• Em ambientes externos com poucas ou nenhuma obstrução, a API Geospatial pode usar os dados de localização do GPS disponíveis para gerar posições geoespaciais com alta precisão.

É possível determinar a disponibilidade do VPS em uma determinada posição horizontal antes do início da sessão de RA e usá-la para criar experiências mais específicas, por exemplo, para mostrar um botão "Entrar no RA" somente quando o VPS estiver disponível.

Ativar a API ARCore

Seu app precisa ativar a API ARCore para verificar a disponibilidade do VPS.

Verificar a disponibilidade do VPS no app

A API Geospatial pode ser usada em qualquer lugar em que o dispositivo consiga determinar a localização. Se a sua experiência de RA depender da cobertura de VPS, use AREarthManager.CheckVpsAvailabilityAsync() para receber uma VpsAvailabilityPromise, uma tarefa assíncrona que verifica a disponibilidade de VPS em uma determinada posição horizontal. Depois de ter o VpsAvailabilityPromise, você pode consultar o resultado.

Consultar o resultado

Use VpsAvailabilityPromise.State para conferir o estado do InterruptiblePromise. Há três estados diferentes:

• Pending: a operação ainda não foi concluída, então nenhum resultado é conhecido.
• Cancelled: a operação foi cancelada por VpsAvailabilityPromise.Cancel(). Nenhum callback registrado será chamado.
• Done: a operação foi concluída. Use VpsAvailabilityPromise.Result para conferir o resultado.

Continue verificando VpsAvailabilityPromise.State até que a tarefa seja concluída.

Cancelar o InterruptiblePromise

Use VpsAvailabilityPromise.Cancel() para tentar cancelar o InterruptiblePromise. Devido ao paralelismo de linhas de execução, é possível que sua tentativa de cancelamento não tenha sucesso.

Usar a API Geospatial sem cobertura de VPS

A API Geospatial também pode ser usada em áreas sem cobertura de VPS. Em ambientes externos com poucas ou nenhuma obstrução acima, o GPS pode ser suficiente para gerar uma pose com alta precisão.

A seguir

• Consiga a pose geoespacial da câmera para determinar a localização exata do dispositivo do usuário no mundo real.