Hotword Private API: Adds speech training functions.

chrome/common/extensions/api/hotword_private.idl

 // Copyright 2014 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 // The <code>chrome.hotwordPrivate</code> API allows extensions to access and
 // mutate the preference for enabling hotword search. It also provides
 // information on whether the hotword search is available. This API provides an
 // event interface to transmit to the extension a signal that the preference fo
 // hotword search has change.
 //
@@ skipping 15 matching lines @@
     // Whether the sound of "Ok, Google" plus a few seconds before is sent
     // back to Google.
     boolean audioLoggingEnabled;
 
     // Whether experimental hotwording functionality is enabled. Mirrors the
     // "enable-experimental-hotwording" flag.
     boolean experimentalHotwordEnabled;
 
     // Whether always-on hotwording is enabled.
     boolean alwaysOnEnabled;
+
+    // Whether training mode is enabled.
+    boolean trainingEnabled;
   };
 
   dictionary LaunchState {
     // TODO(kcarattini): Consider adding more variables here,
     // such as the available state of the hotword service.
 
     // The mode that the Hotword Audio Verification app was launched in.
     long launchMode;
   };
 
@@ skipping 32 matching lines @@
                                        optional GenericDoneCallback callback);
 
     // Notifies that a hotword has been recognized in the browser-requested
     // hotword session.
     static void notifyHotwordRecognition(HotwordType type,
                                          optional GenericDoneCallback callback);
 
     // Retrieves the state that the Hotword Audio Verification app was
     // launched in. The result is put into a LaunchState object.
     static void getLaunchState(LaunchStateCallback callback);
+
+    // Starts the speaker model training.
+    static void startTraining(optional GenericDoneCallback callback);
+
+    // Finalizess the speaker model.
+    static void finalizeSpeakerModel(optional GenericDoneCallback callback);
+
+    // Stops the speaker model training.
+    static void stopTraining(optional GenericDoneCallback callback);
   };
 
   interface Events {
-    // Fired when the hotword search enabled preference is changed.
+    // Fired when the hotword detector enabled state should be changed.
+    // This can be from various sources, e.g. a pref change or training
+    // a speaker model.
     static void onEnabledChanged();
 
     // Fired when the browser wants to start a hotword session.
     static void onHotwordSessionRequested();
 
     // Fired when the browser wants to stop the requested hotword session.
     static void onHotwordSessionStopped();
+
+    // Fired when the speaker model should be finalized.
+    static void onFinalizeSpeakerModel();
+
+    // Fired when a hotword has triggered.
+    static void onHotwordTriggered();
   };
 };