content: /**
   * Copyright (C) 2014 The Android Open Source Project
   *
   * Licensed under the Apache License, Version 2.0 (the "License");
   * you may not use this file except in compliance with the License.
   * You may obtain a copy of the License at
   *
   *      http://www.apache.org/licenses/LICENSE-2.0
   *
   * Unless required by applicable law or agreed to in writing, software
   * distributed under the License is distributed on an "AS IS" BASIS,
   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   * See the License for the specific language governing permissions and
   * limitations under the License.
   */
  
  package com.android.server.soundtrigger;
  
  import android.hardware.soundtrigger.IRecognitionStatusCallback;
  import android.hardware.soundtrigger.SoundTrigger;
  import android.hardware.soundtrigger.SoundTrigger.Keyphrase;
  import android.hardware.soundtrigger.SoundTrigger.KeyphraseRecognitionEvent;
  import android.hardware.soundtrigger.SoundTrigger.KeyphraseRecognitionExtra;
  import android.hardware.soundtrigger.SoundTrigger.KeyphraseSoundModel;
  import android.hardware.soundtrigger.SoundTrigger.ModuleProperties;
  import android.hardware.soundtrigger.SoundTrigger.RecognitionConfig;
  import android.hardware.soundtrigger.SoundTrigger.RecognitionEvent;
  import android.hardware.soundtrigger.SoundTrigger.SoundModelEvent;
  import android.hardware.soundtrigger.SoundTriggerModule;
  
  import java.io.FileDescriptor;
  import java.io.PrintWriter;
  
  /**
   * Provides a local service for managing voice-related recoginition models. This is primarily used
   * by the {@link VoiceInteractionManagerService}.
   */
  public abstract class SoundTriggerInternal {
      /**
       * Return codes for {@link #startRecognition(int, KeyphraseSoundModel,
       *      IRecognitionStatusCallback, RecognitionConfig)},
       * {@link #stopRecognition(int, IRecognitionStatusCallback)}
       */
      public static final int STATUS_ERROR = SoundTrigger.STATUS_ERROR;
      public static final int STATUS_OK = SoundTrigger.STATUS_OK;
  
      /**
       * Starts recognition for the given keyphraseId.
       *
       * @param keyphraseId The identifier of the keyphrase for which
       *        the recognition is to be started.
       * @param soundModel The sound model to use for recognition.
       * @param listener The listener for the recognition events related to the given keyphrase.
       * @return One of {@link #STATUS_ERROR} or {@link #STATUS_OK}.
       */
      public abstract int startRecognition(int keyphraseId, KeyphraseSoundModel soundModel,
              IRecognitionStatusCallback listener, RecognitionConfig recognitionConfig);
  
      /**
       * Stops recognition for the given {@link Keyphrase} if a recognition is
       * currently active.
       *
       * @param keyphraseId The identifier of the keyphrase for which
       *        the recognition is to be stopped.
       * @param listener The listener for the recognition events related to the given keyphrase.
       *
       * @return One of {@link #STATUS_ERROR} or {@link #STATUS_OK}.
       */
      public abstract int stopRecognition(int keyphraseId, IRecognitionStatusCallback listener);
  
      public abstract ModuleProperties getModuleProperties();
  
      /**
       * Unloads (and stops if running) the given keyphraseId
       */
      public abstract int unloadKeyphraseModel(int keyphaseId);
  
      public abstract void dump(FileDescriptor fd, PrintWriter pw, String[] args);
  }
  