chrome/browser/ash/accessibility/dictation.h

// Copyright 2017 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 CHROME_BROWSER_ASH_ACCESSIBILITY_DICTATION_H_
#define CHROME_BROWSER_ASH_ACCESSIBILITY_DICTATION_H_

#include <memory>
#include <string>

#include "base/memory/weak_ptr.h"
#include "base/timer/timer.h"
#include "chrome/browser/speech/speech_recognizer_delegate.h"
#include "content/public/browser/speech_recognition_session_preamble.h"
#include "ui/base/ime/input_method_observer.h"

namespace ui {
struct CompositionText;
class TextInputClient;
}  // namespace ui

class Profile;
class SpeechRecognizer;

namespace ash {

// Provides global dictation (type what you speak) on Chrome OS.
class Dictation : public SpeechRecognizerDelegate,
                  public ui::InputMethodObserver {
 public:
  explicit Dictation(Profile* profile);
  ~Dictation() override;

  // User-initiated dictation.
  bool OnToggleDictation();

 private:
  friend class DictationTest;

  // SpeechRecognizerDelegate:
  void OnSpeechResult(
      const std::u16string& transcription,
      bool is_final,
      const base::Optional<SpeechRecognizerDelegate::TranscriptTiming>&
          word_offsets) override;
  void OnSpeechSoundLevelChanged(int16_t level) override;
  void OnSpeechRecognitionStateChanged(
      SpeechRecognizerStatus new_state) override;

  // ui::InputMethodObserver:
  void OnTextInputStateChanged(const ui::TextInputClient* client) override;
  void OnCaretBoundsChanged(const ui::TextInputClient* client) override {}
  void OnInputMethodDestroyed(const ui::InputMethod* input_method) override {}
  void OnShowVirtualKeyboardIfEnabled() override {}
  void OnFocus() override {}
  void OnBlur() override {}

  // Starts a timer for |timeout_duration|. When the timer expires, will stop
  // capturing audio and finalize any pending utterances.
  void StartSpeechTimeout(base::TimeDelta timeout_duration);
  void StopSpeechTimeout();
  void OnSpeechTimeout();

  // Saves current dictation result and stops listening.
  void DictationOff();

  // Commits the current composition text.
  void CommitCurrentText();

  SpeechRecognizerStatus current_state_;
  bool has_committed_text_ = false;

  std::unique_ptr<SpeechRecognizer> speech_recognizer_;
  std::unique_ptr<ui::CompositionText> composition_;

  Profile* profile_;

  base::OneShotTimer speech_timeout_;
  base::TimeDelta no_speech_timeout_;
  base::TimeDelta no_new_speech_timeout_;

  base::WeakPtrFactory<Dictation> weak_ptr_factory_{this};

  DISALLOW_COPY_AND_ASSIGN(Dictation);
};

}  // namespace ash

#endif  // CHROME_BROWSER_ASH_ACCESSIBILITY_DICTATION_H_