| /* |
| * 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.internal.app; |
| |
| import android.content.ComponentName; |
| import android.content.Intent; |
| import android.os.Bundle; |
| |
| import com.android.internal.app.IVoiceActionCheckCallback; |
| import com.android.internal.app.IVoiceInteractionSessionShowCallback; |
| import com.android.internal.app.IVoiceInteractor; |
| import com.android.internal.app.IVoiceInteractionSessionListener; |
| import android.hardware.soundtrigger.IRecognitionStatusCallback; |
| import android.hardware.soundtrigger.SoundTrigger; |
| import android.service.voice.IVoiceInteractionService; |
| import android.service.voice.IVoiceInteractionSession; |
| |
| interface IVoiceInteractionManagerService { |
| void showSession(IVoiceInteractionService service, in Bundle sessionArgs, int flags); |
| boolean deliverNewSession(IBinder token, IVoiceInteractionSession session, |
| IVoiceInteractor interactor); |
| boolean showSessionFromSession(IBinder token, in Bundle sessionArgs, int flags); |
| boolean hideSessionFromSession(IBinder token); |
| int startVoiceActivity(IBinder token, in Intent intent, String resolvedType); |
| int startAssistantActivity(IBinder token, in Intent intent, String resolvedType); |
| void setKeepAwake(IBinder token, boolean keepAwake); |
| void closeSystemDialogs(IBinder token); |
| void finish(IBinder token); |
| void setDisabledShowContext(int flags); |
| int getDisabledShowContext(); |
| int getUserDisabledShowContext(); |
| |
| /** |
| * Gets the registered Sound model for keyphrase detection for the current user. |
| * May be null if no matching sound model exists. |
| * |
| * @param keyphraseId The unique identifier for the keyphrase. |
| * @param bcp47Locale The BCP47 language tag for the keyphrase's locale. |
| */ |
| SoundTrigger.KeyphraseSoundModel getKeyphraseSoundModel(int keyphraseId, in String bcp47Locale); |
| /** |
| * Add/Update the given keyphrase sound model. |
| */ |
| int updateKeyphraseSoundModel(in SoundTrigger.KeyphraseSoundModel model); |
| /** |
| * Deletes the given keyphrase sound model for the current user. |
| * |
| * @param keyphraseId The unique identifier for the keyphrase. |
| * @param bcp47Locale The BCP47 language tag for the keyphrase's locale. |
| */ |
| int deleteKeyphraseSoundModel(int keyphraseId, in String bcp47Locale); |
| |
| /** |
| * Gets the properties of the DSP hardware on this device, null if not present. |
| */ |
| SoundTrigger.ModuleProperties getDspModuleProperties(in IVoiceInteractionService service); |
| /** |
| * Indicates if there's a keyphrase sound model available for the given keyphrase ID. |
| * This performs the check for the current user. |
| * |
| * @param service The current VoiceInteractionService. |
| * @param keyphraseId The unique identifier for the keyphrase. |
| * @param bcp47Locale The BCP47 language tag for the keyphrase's locale. |
| */ |
| boolean isEnrolledForKeyphrase(IVoiceInteractionService service, int keyphraseId, |
| String bcp47Locale); |
| /** |
| * Starts a recognition for the given keyphrase. |
| */ |
| int startRecognition(in IVoiceInteractionService service, int keyphraseId, |
| in String bcp47Locale, in IRecognitionStatusCallback callback, |
| in SoundTrigger.RecognitionConfig recognitionConfig); |
| /** |
| * Stops a recognition for the given keyphrase. |
| */ |
| int stopRecognition(in IVoiceInteractionService service, int keyphraseId, |
| in IRecognitionStatusCallback callback); |
| |
| /** |
| * @return the component name for the currently active voice interaction service |
| */ |
| ComponentName getActiveServiceComponentName(); |
| |
| /** |
| * Shows the session for the currently active service. Used to start a new session from system |
| * affordances. |
| * |
| * @param args the bundle to pass as arguments to the voice interaction session |
| * @param sourceFlags flags indicating the source of this show |
| * @param showCallback optional callback to be notified when the session was shown |
| * @param activityToken optional token of activity that needs to be on top |
| */ |
| boolean showSessionForActiveService(in Bundle args, int sourceFlags, |
| IVoiceInteractionSessionShowCallback showCallback, IBinder activityToken); |
| |
| /** |
| * Hides the session from the active service, if it is showing. |
| */ |
| void hideCurrentSession(); |
| |
| /** |
| * Notifies the active service that a launch was requested from the Keyguard. This will only |
| * be called if {@link #activeServiceSupportsLaunchFromKeyguard()} returns true. |
| */ |
| void launchVoiceAssistFromKeyguard(); |
| |
| /** |
| * Indicates whether there is a voice session running (but not necessarily showing). |
| */ |
| boolean isSessionRunning(); |
| |
| /** |
| * Indicates whether the currently active voice interaction service is capable of handling the |
| * assist gesture. |
| */ |
| boolean activeServiceSupportsAssist(); |
| |
| /** |
| * Indicates whether the currently active voice interaction service is capable of being launched |
| * from the lockscreen. |
| */ |
| boolean activeServiceSupportsLaunchFromKeyguard(); |
| |
| /** |
| * Called when the lockscreen got shown. |
| */ |
| void onLockscreenShown(); |
| |
| /** |
| * Register a voice interaction listener. |
| */ |
| void registerVoiceInteractionSessionListener(IVoiceInteractionSessionListener listener); |
| |
| /** |
| * Checks the availability of a set of voice actions for the current active voice service. |
| * Returns all supported voice actions. |
| */ |
| void getActiveServiceSupportedActions(in List<String> voiceActions, |
| in IVoiceActionCheckCallback callback); |
| |
| /** |
| * Sets the transcribed voice to the given string. |
| */ |
| void setTranscription(String transcription); |
| |
| /** |
| * Indicates that the transcription session is finished. |
| */ |
| void clearTranscription(boolean immediate); |
| |
| /** |
| * Sets the voice state indication based upon the given value. |
| */ |
| void setVoiceState(int state); |
| } |