Introducing new data types and IPC messages for scripted JS speech recognition APIs (Speech CL2.0)

content/public/browser/speech_recognition_session_context.h

 // Copyright (c) 2012 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.
 
 #ifndef CONTENT_PUBLIC_BROWSER_SPEECH_RECOGNITION_SESSION_CONTEXT_H_
 #define CONTENT_PUBLIC_BROWSER_SPEECH_RECOGNITION_SESSION_CONTEXT_H_
+#pragma once
 
 #include "content/common/content_export.h"
 #include "ui/gfx/rect.h"
 
 namespace content {
 
 // The context information required by clients of the SpeechRecognitionManager
-// (InputTagSpeechDispatcherHost) and its delegates for mapping the recognition
-// session to other browser elements involved with the it (e.g., the page
-// element that requested the recognition). The SpeechRecognitionManager is
-// not aware of the content of this struct and does NOT use it for its purposes.
-// However the manager keeps this struct "attached" to the recognition session
-// during all the session lifetime, making its contents available to clients
-// (In this regard, see SpeechRecognitionManager::GetSessionContext and
+// and its delegates for mapping the recognition session to other browser
+// elements involved with it (e.g., the page element that requested the
+// recognition). The SpeechRecognitionManager is not aware of the content of
+// this struct and does NOT use it for its purposes. However the manager keeps
+// this struct "attached" to the recognition session during all the session
+// lifetime, making its contents available to clients (In this regard, see
+// SpeechRecognitionManager::GetSessionContext and
 // SpeechRecognitionManager::LookupSessionByContext methods).
 struct CONTENT_EXPORT SpeechRecognitionSessionContext {
   SpeechRecognitionSessionContext()
       : render_process_id(0),
         render_view_id(0),
-        render_request_id(0) {}
+        render_request_id(0),
+        js_handle_id(0) {}
   ~SpeechRecognitionSessionContext() {}
 
   int render_process_id;
   int render_view_id;
   int render_request_id;
+  int js_handle_id;

[Satish, 2012/04/27 10:04:41]

typically 'handle' and 'id' are used mutually exclusive. What is the purpose of
this field?

[Primiano Tucci (use gerrit), 2012/04/27 15:58:44]

It is the numeric id that is (will be) mapped to the webkit object
WebSpeechReecognitionHandle.

   gfx::Rect element_rect;
 };
 
 }  // namespace content
 
 #endif  // CONTENT_PUBLIC_BROWSER_SPEECH_RECOGNITION_SESSION_CONTEXT_H_