Hotword Audio Verification App: Adds to hotwordPrivate API

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 17 matching lines @@
     boolean audioLoggingEnabled;
 
     // Whether experimental hotwording functionality is enabled. Mirrors the
     // "enable-experimental-hotwording" flag.
     boolean experimentalHotwordEnabled;
 
     // Whether always-on hotwording is enabled.
     boolean alwaysOnEnabled;
   };
 
+  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;
+  };
+
+
   // The type of the recognized hotword. Right now it only has 'search' but
   // could be expanded to other types of actions in the future.
   enum HotwordType { search };
 
   callback GenericDoneCallback = void ();
+  callback LaunchStateCallback = void(LaunchState result);
   callback StatusDetailsCallback = void(StatusDetails result);
 
   interface Functions {
     // Sets the current enabled state of hotword search.
     // True: enable hotword search. False: disable hotword search.
     static void setEnabled(boolean state,
                            optional GenericDoneCallback callback);
 
     // Retrieves the current state of hotword search.
     // The result is put into a StatusDetails object.
     static void getStatus(StatusDetailsCallback callback);
 
     // Sets the current enabled state of audio logging in the extension.
     // True: logging enabled. False: no logging.
     static void setAudioLoggingEnabled(boolean state,
                                        optional GenericDoneCallback callback);
 
     // Sets the current state of the browser-requested hotword session.
     static void setHotwordSessionState(boolean started,
                                        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);
   };
 
   interface Events {
     // Fired when the hotword search enabled preference is changed.
     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();
   };
 };