Merge "Create a callback method to invoke when the hotword detector is restarted." into sc-dev

core/api/system-current.txt

@@ -10495,6 +10495,7 @@ package android.service.voice {
     ctor public AlwaysOnHotwordDetector.Callback();
     method public abstract void onAvailabilityChanged(int);
     method public void onHotwordDetectionServiceInitialized(int);
+    method public void onHotwordDetectionServiceRestarted();
     method public void onRejected(@Nullable android.service.voice.HotwordRejectedResult);
   }
 
@@ -10571,6 +10572,7 @@ package android.service.voice {
     method public void onDetected(@NonNull android.service.voice.AlwaysOnHotwordDetector.EventPayload);
     method public void onError();
     method public void onHotwordDetectionServiceInitialized(int);
+    method public void onHotwordDetectionServiceRestarted();
     method public void onRecognitionPaused();
     method public void onRecognitionResumed();
     method public void onRejected(@Nullable android.service.voice.HotwordRejectedResult);

core/java/android/service/voice/AlwaysOnHotwordDetector.java

@@ -535,6 +535,15 @@ public class AlwaysOnHotwordDetector extends AbstractHotwordDetector {
          */
         public void onHotwordDetectionServiceInitialized(@InitializationStatus int status) {
         }
+
+        /**
+         * Called with the {@link HotwordDetectionService} is restarted.
+         *
+         * Clients are expected to call {@link HotwordDetector#updateState} to share the state with
+         * the newly created service.
+         */
+        public void onHotwordDetectionServiceRestarted() {
+        }
     }
 
     /**

core/java/android/service/voice/HotwordDetector.java

@@ -169,5 +169,13 @@ public interface HotwordDetector {
          * @param status Info about initialization state of {@link HotwordDetectionService}.
          */
         void onHotwordDetectionServiceInitialized(@InitializationStatus int status);
+
+        /**
+         * Called with the {@link HotwordDetectionService} is restarted.
+         *
+         * Clients are expected to call {@link HotwordDetector#updateState} to share the state with
+         * the newly created service.
+         */
+        void onHotwordDetectionServiceRestarted();
     }
 }