Visão geral da API Fence

Na API Awareness, o conceito de cercas é tirado da fronteira geográfica virtual, em que uma região geográfica, ou geofence, é definida, e um app recebe callbacks quando um usuário entra ou sai da região da fronteira geográfica virtual. A API Fence expande o conceito de fronteira geográfica virtual para incluir muitas outras condições de contexto, além da proximidade geográfica. Um app recebe callbacks sempre que o estado do contexto muda. Por exemplo, se o app definir uma fronteira para fones de ouvido, ele vai receber callbacks quando os fones de ouvido estiverem conectados e desconectados.

Você pode usar a API cerca para definir limites com base em indicadores de contexto, como estes:

  • A localização atual do usuário (latitude/longitude)
  • A atividade atual do usuário, como caminhar ou dirigir.
  • Condições específicas do dispositivo, por exemplo, se os fones de ouvido estão conectados.
  • Proximidade de sensores próximos

A API Fence permite combinar vários indicadores de contexto para criar fronteiras com operadores booleanos AND, OR e NOT. Seu app recebe callbacks sempre que as condições da cerca são atendidas. Veja alguns exemplos de cercas possíveis:

  • O usuário conecta fones de ouvido e começa a andar.
  • O usuário insere uma fronteira geográfica virtual de 100 metros antes das 17h em um dia da semana.
  • O usuário insere um intervalo de um beacon BLE específico.

O exemplo a seguir mostra como definir uma cerca que é ativada sempre que o usuário caminha:

AwarenessFence walkingFence = DetectedActivityFence.during(DetectedActivityFence.WALKING);

Depois de definir uma cerca, faça o seguinte:

  • Chame updateFences para registrar a fronteira para receber callbacks.
  • Defina um callback que possa ser invocado quando o estado de limite mudar.

O exemplo a seguir mostra um método que cria e registra uma cerca. Neste exemplo, uma subclasse personalizada de BroadcastReceiver é usada para processar a intent quando o limite é acionado.

Awareness.getFenceClient(this).updateFences(new FenceUpdateRequest.Builder()
    .addFence(FENCE_KEY, exercisingWithHeadphonesFence, mPendingIntent)
    .build())
    .addOnSuccessListener(new OnSuccessListener<Void>() {
        @Override
        public void onSuccess(Void aVoid) {
            Log.i(TAG, "Fence was successfully registered.");
        }
    })
    .addOnFailureListener(new OnFailureListener() {
        @Override
        public void onFailure(@NonNull Exception e) {
            Log.e(TAG, "Fence could not be registered: " + e);
        }
    });
public class FenceReceiver extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {

        FenceState fenceState = FenceState.extract(intent);

        if (TextUtils.equals(fenceState.getFenceKey(), FENCE_KEY)) {
            String fenceStateStr;
            switch (fenceState.getCurrentState()) {
                case FenceState.TRUE:
                    fenceStateStr = "true";
                    break;
                case FenceState.FALSE:
                    fenceStateStr = "false";
                    break;
                case FenceState.UNKNOWN:
                    fenceStateStr = "unknown";
                    break;
                default:
                    fenceStateStr = "unknown value";
            }
            mLogFragment.getLogView().println("Fence state: " + fenceStateStr);
        }
    }
}