Diese Seite wurde von der Cloud Translation API übersetzt.

Snapshot-Daten abrufen

In diesem Abschnitt wird beschrieben, wie Sie mit der Snapshot API den aktuellen Status für die einzelnen unterstützten Kontexttypen abrufen. Weitere Informationen finden Sie unter Erste Schritte. Weitere Informationen zu eingestellten kontextbezogenen Signalen finden Sie in der folgenden aufklappbaren Mitteilung:

Hinweis zur Einstellung: Kontextsignale für Orte und Wetter

Aktuelle Aktivität abrufen

Rufen Sie getDetectedActivity() auf, um die aktuelle Aktivität des Nutzers abzurufen. Dadurch wird ein ActivityRecognitionResult zurückgegeben, das Informationen zu den letzten Aktivitäten des Nutzers enthält.

Für die Methode getDetectedActivity() ist die Berechtigung com.google.android.gms.permission.ACTIVITY_RECOGNITION erforderlich. Fügen Sie diese Berechtigung zu AndroidManifest.xml hinzu.

So rufen Sie die aktuelle Aktivität des Nutzers ab:

Rufen Sie getSnapshotClient() auf, um eine Instanz von SnapshotClient zu erstellen.
Verwenden Sie addOnSuccessListener, um einen OnSuccessListener zu erstellen, der auf ein DetectedActivityResponse warten kann.
Rufen Sie getStatus() auf, um sicherzustellen, dass das Ergebnis gültig ist.
Rufen Sie DetectedActivityResponse.getActivityRecognitionResult() auf, um ein ActivityRecognitionResult zurückzugeben. Damit können Sie viele Aspekte der aktuellen Aktivität des Nutzers abrufen. Beispiel:
- Rufen Sie getMostProbableActivity() auf, um nur die wahrscheinlichste Aktivität zu erhalten.
- Rufen Sie getProbableActivities() auf, um eine Liste der letzten Aktivitäten zu erhalten, die nach Wahrscheinlichkeit sortiert sind.
- Rufen Sie getActivityConfidence() auf, um den Konfidenzwert für einen bestimmten Aktivitätstyp zurückzugeben.
- Rufen Sie hasResult() auf, um zu erkennen, ob ein Intent ein ActivityRecognitionResult enthält.

Im folgenden Codebeispiel wird getMostProbableActivity() verwendet, um die wahrscheinlichste erkannte Aktivität abzurufen und das Ergebnis in der Konsole zu protokollieren:

Awareness.getSnapshotClient(this).getDetectedActivity()
    .addOnSuccessListener(new OnSuccessListener<DetectedActivityResponse>() {
        @Override
        public void onSuccess(DetectedActivityResponse dar) {
            ActivityRecognitionResult arr = dar.getActivityRecognitionResult();
            DetectedActivity probableActivity = arr.getMostProbableActivity();

            int confidence = probableActivity.getConfidence();
            String activityStr = probableActivity.toString();
            mLogFragment.getLogView().println("Activity: " + activityStr
                + ", Confidence: " + confidence + "/100");
        }
    })

Beacons in der Nähe abrufen

Wenn Sie Informationen zu Beacons in der Nähe erhalten möchten, rufen Sie getBeaconState() auf. Beacon-Daten bestehen aus dem Inhalt, dem Typ und dem Namespace aller Anhänge.

Für die Methode getBeaconState() ist die Berechtigung android.permission.ACCESS_FINE_LOCATION erforderlich. Fügen Sie diese Berechtigung zu AndroidManifest.xml hinzu. Außerdem müssen Sie die Nearby Messages API für Ihr Google Developers Console-Projekt aktivieren. Weitere Informationen finden Sie unter Registrierung und API-Schlüssel und Erste Schritte.

So rufen Sie Informationen zu Beacons in der Nähe ab:

Prüfen Sie, ob der Nutzer die erforderlichen Berechtigungen erteilt hat. Im folgenden Beispiel wird geprüft, ob die Berechtigung android.permission.ACCESS_FINE_LOCATION erteilt wurde. Andernfalls wird der Nutzer um Einwilligung gebeten.

if (ContextCompat.checkSelfPermission(
            MainActivity.this,
            Manifest.permission.ACCESS_FINE_LOCATION) !=
            PackageManager.PERMISSION_GRANTED) {
        ActivityCompat.requestPermissions(
                MainActivity.this,
                new String[]{Manifest.permission.ACCESS_FINE_LOCATION},
                MY_PERMISSION_LOCATION
        );
        return;
    }

Definieren Sie eine BeaconState.TypeFilter. Es werden nur Beacons mit Anhängen zurückgegeben, die mit dem angegebenen Namespace und Typ registriert sind. Sie können auch nach einer Byte-für-Byte-Übereinstimmung des Anhanginhalts filtern. Das folgende Beispiel zeigt, wie ein Typfilter erstellt wird:

private static final List<BeaconState.TypeFilter> BEACON_TYPE_FILTERS = Arrays.asList(
        BeaconState.TypeFilter.with(
            "my.beacon.namespace",
            "my-attachment-type"),
        BeaconState.TypeFilter.with(
            "my.other.namespace",
            "my-attachment-type"));

Rufen Sie getSnapshotClient.getBeaconState() auf.
Verwenden Sie addOnSuccessListener, um einen OnSuccessListener zu erstellen, der auf ein BeaconStateResponse warten kann.
Rufen Sie getStatus() auf, um sicherzustellen, dass das Ergebnis gültig ist.
Rufen Sie BeaconStateResponse.getBeaconState() auf, um den Beacon-Status zurückzugeben.
Rufen Sie BeaconState.getBeaconInfo() auf, um eine BeaconState.BeaconInfo abzurufen.

Das folgende Beispiel zeigt, wie Sie Beacon-Informationen abrufen:

Awareness.getSnapshotClient(this).getBeaconState(BEACON_TYPE_FILTERS)
    .addOnSuccessListener(new OnSuccessListener<BeaconStateResponse>() {
        @Override
        public void onSuccess(BeaconStateResponse beaconStateResponse) {
            BeaconStateResult beaconStateResult = beaconStateResponse.getBeaconState();
            BeaconState.BeaconInfo beaconInfo = beaconStateResponse.getBeaconInfo();
        }
    })

Kopfhörerstatus abrufen

Rufen Sie getHeadphoneState() auf, um zu erkennen, ob Kopfhörer an das Gerät angeschlossen sind. Dadurch wird ein HeadphoneStateResponse-Erkennungsstatus mit OnSuccessListener auf „detect“ gesetzt. Anschließend können Sie getHeadphoneState() aufrufen, um HeadphoneState abzurufen.

So rufst du den aktuellen Kopfhörerstatus ab:

Rufen Sie getSnapshotClient.getHeadphoneState() auf.
Verwenden Sie addOnSuccessListener, um einen OnSuccessListener zu erstellen, der auf ein HeadphoneStateResponse warten kann.
Rufen Sie getStatus() auf, um sicherzustellen, dass das Ergebnis gültig ist.
Rufen Sie bei Erfolg HeadphoneStateResponse.getHeadphoneState() auf, um den Kopfhörerstatus zurückzugeben. Dieser Wert ist entweder PLUGGED_IN oder UNPLUGGED.

Das folgende Codebeispiel zeigt, wie getHeadphoneState() verwendet wird:

Awareness.getSnapshotClient(this).getHeadphoneState()
    .addOnSuccessListener(new OnSuccessListener<HeadphoneStateResponse>() {
        @Override
        public void onSuccess(HeadphoneStateResponse headphoneStateResponse) {
            HeadphoneState headphoneState = headphoneStateResponse.getHeadphoneState();
            boolean pluggedIn = headphoneState.getState() == HeadphoneState.PLUGGED_IN;
            String stateStr =
                "Headphones are " + (pluggedIn ? "plugged in" : "unplugged");
            mLogFragment.getLogView().println(stateStr);
        }
    })
    .addOnFailureListener(new OnFailureListener() {
        @Override
        public void onFailure(@NonNull Exception e) {
            Log.e(TAG, "Could not get headphone state: " + e);
        }
    });

Standort abrufen

Sie können den aktuellen Standort des Nutzers (Breiten- und Längengrad) mit einem Aufruf von getLocation() abrufen. Dadurch wird ein LocationResponse zurückgegeben. Anschließend können Sie LocationResponse.getLocation() aufrufen, um ein Location mit den aktuellen Standortdaten zu erhalten.

Für die Methode getLocation() ist die Berechtigung android.permission.ACCESS_FINE_LOCATION erforderlich. Fügen Sie diese Berechtigung zu AndroidManifest.xml hinzu.

So rufen Sie den aktuellen Standort ab:


if (ContextCompat.checkSelfPermission(
            MainActivity.this,
            Manifest.permission.ACCESS_FINE_LOCATION) !=
            PackageManager.PERMISSION_GRANTED) {
        ActivityCompat.requestPermissions(
                MainActivity.this,
                new String[]{Manifest.permission.ACCESS_FINE_LOCATION},
                MY_PERMISSION_LOCATION
        );
        return;
    }

Rufen Sie getSnapshotClient.getLocation() auf.
Verwenden Sie addOnSuccessListener, um einen OnSuccessListener zu erstellen, der auf ein LocationResponse warten kann.
Rufen Sie getStatus() auf, um sicherzustellen, dass das Ergebnis gültig ist.
Rufen Sie LocationResponse.getLocation() auf, um die aktuelle Location zurückzugeben.

Im folgenden Beispiel wird gezeigt, wie der aktuelle Standort abgerufen wird:

Awareness.getSnapshotClient(this).getLocation()
    .addOnSuccessListener(new OnSuccessListener<LocationResponse>() {
        @Override
        public void onSuccess(LocationResponse locationResponse) {
            Location loc = locationResponse.getLocationResult();
        }
    })