Informationen zum Kamerawechselereignis der Google Maps Android API

Die Google Maps-Bibliothek für Android hat ein Ereignis "GoogleMap.OnCameraChangeListener", das auftritt, wenn eine Kamera geändert wird (= Änderung der Position, Drehung, Neigung).

Mit der Veröffentlichung im August 2016 wurde "OnCameraChangeListener" jedoch nicht mehr unterstützt und stattdessen wurden vier neue Ereignisse hinzugefügt.

• Release Notes - August 1, 2016 ｜  Google Maps Android API

This release introduces a set of new camera change listeners for camera motion start, ongoing, and end events. You can also see why the camera is moving, whether it's caused by user gestures, built-in API animations or developer-controlled movements. Below is a summary of the new listeners. For details, see the guide to camera change events. (Issue 4636)

• The onCameraMoveStarted() callback of the OnCameraMoveStartedListener is invoked when the camera starts moving. The callback method receives a reason for the camera motion.
• The onCameraMove() callback of the OnCameraMoveListener is invoked multiple times while the camera is moving or the user is interacting with the touch screen.
• The OnCameraIdle() callback of the OnCameraIdleListener is invoked when the camera stops moving and the user has stopped interacting with the map.
• The OnCameraMoveCanceled() callback of the OnCameraMoveCanceledListener is invoked when the current camera movement has been interrupted.

onCameraMoveStarted - Wenn sich die Kamera in Bewegung setzt

Tritt einmal unmittelbar nach dem Bewegen der Kamera auf. Gleiches gilt für das Bewegen der Kamera mit Methoden wie "updateCamera" und "animateCamera" sowie mit Gesten wie Ziehen und Kneifen.

onCameraMoveIdle-Wenn die Kamera fertig ist

Tritt einmal unmittelbar nach Abschluss der Kamerabewegung auf. Mit anderen Worten, wenn eine Ansichtsänderung auftritt, wird "onCameraMoveIdle" am Ende einmal aufgerufen. Das onCameraMoveIdle wird immer noch aufgerufen, wenn die Animation abgebrochen wird. Es ähnelt in seiner Position dem veralteten "onCameraChange". Übrigens, nachdem "onCameraChange" aufgerufen wurde, wird "onCameraMoveIdle" aufgerufen.

Wenn "onCameraMoveStarted" und "onCameraMoveIdle" immer gepaart sind, gibt es ** Fälle, in denen dies nicht der Fall ist. Dies ist der Fall, wenn die Karte durch Ziehen der Karte verschoben wird, während die Karte von "animateCamera" verschoben wird. Dies wird später besprochen.

onCameraMove - wenn sich die Kamera bewegt

Tritt auf, wenn sich die Kamera bewegt. Bei direkten Kamerapositionsbewegungen mit moveCamera kann dieses Ereignis ** auftreten ** oder nicht **. Animierte Bewegungen mit "animateCamera" lösen dieses Ereignis während der Animation aus. Dies tritt auch bei Gestenoperationen wie Ziehen und Kneifen auf.

onCameraMoveCanceled - wenn die Animation abgebrochen wird

Tritt auf, wenn eine animierte Kamerabewegung, z. B. "animateCamera", durch eine Aktion abgebrochen wird. "Irgendeine Operation" ist

• Wird während der Animation von stopAnimation aufgerufen
• Tippen oder ziehen Sie den Bildschirm während der Animation

ist.

[Bonus] animateCamera Rückruf

Für animateCamera können Sie einen Rückruf angeben, der den Abschluss / die Stornierung der Animation erhalten kann.

public final void animateCamera (
    CameraUpdate update, 
    GoogleMap.CancelableCallback callback)

Status des Ereignisses für jeden Fall

Ich habe eine Beispiel-App erstellt und versucht herauszufinden, welche Art von Ereignis im tatsächlichen Betrieb auftreten würde.

Ausführen der updateCamera-Methode

1. onCameraMoveStarted
2. onCameraMove ← Kann nicht auftreten
3. ~~onCameraChange~~
4. onCameraIdle

** Es scheint, dass "onCameraMove" auftreten kann oder nicht **, ich war mir über den Zustand nicht sicher (es scheint, dass "onCameraMove" nicht auftritt, weil sich die Position ändert) ). Da onCameraChange veraltet ist, ist es durchgestrichen.

Ausführung der animateCamera-Methode (ohne Unterbrechung)

1. onCameraMoveStarted
2. onCameraMove
3. onCameraMove
4. ・ ・ ・
5. animateCamera_onFinish
6. ~~onCameraChange~~
7. onCameraIdle

OnCameraMove wird während des Umzugs mehrmals aufgerufen. Die Häufigkeit hängt von der Geschwindigkeit der Animation ab. Wenn der Umzug abgeschlossen ist, wird der Rückruf der Methode "animateCamera" über "onFinish" benachrichtigt und anschließend "onCameraIdle" aufgerufen.

Führen Sie die animateCamera-Methode aus → Führen Sie stopAnimation aus

1. onCameraMoveStarted
2. onCameraMove
3. ・ ・ ・
4. onCameraMove
5. Rufen Sie stopAnimation auf
6. onCameraMoveCanceled
7. animateCamera_onCancel
8. ~~onCameraChange~~
9. onCameraIdle

Wenn Sie während der Animation stopAnimation aufrufen, bleibt die Kamera stehen und Sie werden über den Stopp in der Reihenfolge onCameraMoveCanceled → animateCamera_onCancel benachrichtigt. Danach wird "onCameraIdle" genau so aufgerufen, wie es abgeschlossen wurde.

Ausführung der animateCamera-Methode → Ziehen Sie während des Verschiebens, um die Karte zu verschieben

1. onCameraMoveStarted ← Bewegen Sie sich mit animateCamera
2. onCameraMove
3. ・ ・ ・
4. onCameraMove
5. Ziehen Sie, um die Karte zu verschieben
6. onCameraMoveCanceled
7. onCameraMoveStarted ← Bewegen Sie sich durch Ziehen
8. animateCamera_onCancel
9. onCameraMove
10. onCameraMove
11. ・ ・ ・
12. Hören Sie auf zu ziehen
13. ~~ onCameraChange ~~ ← Bewegungsende von animateCamera?
14. onCameraMove
15. onCameraMove
16. ~~ onCameraChange ~~ ← Bewegungsende durch Ziehen?
17. onCameraIdle

Wenn Sie beim Verschieben der Karte ziehen, benachrichtigt Sie "onCameraMoveCanceled" über die Unterbrechung und sofort über "onCameraMoveStarted" als neue Kamerabewegung. Erst danach wird animateCamera benachrichtigt, dass die Animation animateCamera_onCancel gestoppt hat.

Danach trat "onCameraMove" durch Ziehen kontinuierlich auf, und als das Ziehen gestoppt wurde, wurde ~~ onCameraChange ~~ zweimal aufgerufen und onCameraIdle am Ende einmal aufgerufen.

Das Folgende ist eine Zusammenfassung der Punkte, die in diesem Fall zu beachten sind.

• OnCameraMoveStarted durch Ziehen wird benachrichtigt, bevor onCancel an animateCamera benachrichtigt wird.
• OnCameraMoveStarted wird zweimal benachrichtigt (wenn animateCamera aufgerufen wird und wenn das Ziehen beginnt), aber onCameraIdle wird am Ende nur einmal benachrichtigt.

Wenn Sie mehrere Ereignisse mit RxJava usw. streamen, müssen Sie die Reihenfolge und Anzahl der auftretenden Ereignisse kennen, aber ich bin der Meinung, dass dies zu diesem Zeitpunkt möglicherweise ein Problem darstellt.

Rufen Sie stopAnimation auf, wenn Sie nicht animiert sind

1. ~~onCameraChange~~
2. onCameraIdle

Wenn Sie einfach stopAnimation aufrufen, wird ~~ onCameraChange ~~, onCameraIdle aufgerufen. Es fühlt sich schlecht an.

Zusammenfassung

• Sie können "onCameraIdle" als Alternative zum veralteten "onCameraChange" verwenden. Beachten Sie jedoch, dass der Zeitpunkt des Auftretens für Bimyo unterschiedlich sein kann!
• Das neu hinzugefügte "onCameraMoveStarted" kann die Kamera bewegen, und "onCameraMove" kann die sich bewegende Kamera empfangen.
• onCameraXXXX benachrichtigt Sie nicht nur, wenn die Kamera durch die Methode bewegt wird, sondern auch, wenn die Kamera durch die Geste bewegt wird. Das Ende / die Unterbrechung der Animation von "animateCamera" wird durch den Rückruf des Arguments empfangen.

[Bonus] Google Maps SDK für iOS

Im Google Maps SDK für iOS, unserer Schwesterbibliothek, kamerabezogene Ereignisse

• Protocol Reference  ｜  Google Maps SDK for iOS

Es ist in. demzufolge,

• willMove
• didChangeCameraPosition
• idleAtCameraPosition

es gibt. Es ist ärgerlich, weil es für Android ist. .. ..