import com.android.internal.app.IVoiceInteractionManagerService;
+import java.io.FileDescriptor;
+import java.io.PrintWriter;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
* Additional payload for {@link Callback#onDetected}.
*/
public static class EventPayload {
+ private final boolean mTriggerAvailable;
+ // Indicates if {@code captureSession} can be used to continue capturing more audio
+ // from the DSP hardware.
+ private final boolean mCaptureAvailable;
+ // The session to use when attempting to capture more audio from the DSP hardware.
+ private final int mCaptureSession;
+ private final AudioFormat mAudioFormat;
+ // Raw data associated with the event.
+ // This is the audio that triggered the keyphrase if {@code isTriggerAudio} is true.
+ private final byte[] mData;
+
+ private EventPayload(boolean triggerAvailable, boolean captureAvailable,
+ AudioFormat audioFormat, int captureSession, byte[] data) {
+ mTriggerAvailable = triggerAvailable;
+ mCaptureAvailable = captureAvailable;
+ mCaptureSession = captureSession;
+ mAudioFormat = audioFormat;
+ mData = data;
+ }
+
/**
- * Indicates if {@code data} is the audio that triggered the keyphrase.
+ * Gets the format of the audio obtained using {@link #getTriggerAudio()}.
+ * May be null if there's no audio present.
*/
- public final boolean triggerAvailable;
+ @Nullable
+ public AudioFormat getCaptureAudioFormat() {
+ return mAudioFormat;
+ }
+
/**
- * Indicates if {@code captureSession} can be used to continue capturing more audio from
- * the DSP hardware.
+ * Gets the raw audio that triggered the keyphrase.
+ * This may be null if the trigger audio isn't available.
+ * If non-null, the format of the audio can be obtained by calling
+ * {@link #getCaptureAudioFormat()}.
*
- * Candidate for public API
- * @hide
+ * @see AlwaysOnHotwordDetector#RECOGNITION_FLAG_CAPTURE_TRIGGER_AUDIO
*/
- public final boolean captureAvailable;
+ @Nullable
+ public byte[] getTriggerAudio() {
+ if (mTriggerAvailable) {
+ return mData;
+ } else {
+ return null;
+ }
+ }
+
/**
- * The session to use when attempting to capture more audio from the DSP hardware.
+ * Gets the session ID to start a capture from the DSP.
+ * This may be null if streaming capture isn't possible.
+ * If non-null, the format of the audio that can be captured can be
+ * obtained using {@link #getCaptureAudioFormat()}.
+ *
+ * TODO: Candidate for Public API when the API to start capture with a session ID
+ * is made public.
+ *
+ * TODO: Add this to {@link #getCaptureAudioFormat()}:
+ * "Gets the format of the audio obtained using {@link #getTriggerAudio()}
+ * or {@link #getCaptureSession()}. May be null if no audio can be obtained
+ * for either the trigger or a streaming session."
+ *
+ * TODO: Should this return a known invalid value instead?
*
- * Candidate for public API
- * TODO: When unhiding, change javadoc of audioFormat to -
- * "Format of {@code data} or the audio that may be captured using {@code captureSession}.
- * May be null if {@code triggerAvailable} and {@code captureAvailable} are false."
* @hide
*/
- public final int captureSession;
- /**
- * Format of {@code data}.
- * May be null if {@code triggerAvailable} is false.
- */
@Nullable
- public final AudioFormat audioFormat;
- /**
- * Raw data associated with the event.
- * This is the audio that triggered the keyphrase if {@code isTriggerAudio} is true.
- */
- @Nullable
- public final byte[] data;
-
- private EventPayload(boolean _triggerAvailable, boolean _captureAvailable,
- AudioFormat _audioFormat, int _captureSession, byte[] _data) {
- triggerAvailable = _triggerAvailable;
- captureAvailable = _captureAvailable;
- captureSession = _captureSession;
- audioFormat = _audioFormat;
- data = _data;
+ public Integer getCaptureSession() {
+ if (mCaptureAvailable) {
+ return mCaptureSession;
+ } else {
+ return null;
+ }
}
}
new RecognitionConfig(captureTriggerAudio, allowMultipleTriggers,
recognitionExtra, null /* additional data */));
} catch (RemoteException e) {
- Slog.w(TAG, "RemoteException in startRecognition!");
+ Slog.w(TAG, "RemoteException in startRecognition!", e);
}
if (code != STATUS_OK) {
Slog.w(TAG, "startRecognition() failed with error code " + code);
code = mModelManagementService.stopRecognition(
mVoiceInteractionService, mKeyphraseMetadata.id, mInternalCallback);
} catch (RemoteException e) {
- Slog.w(TAG, "RemoteException in stopRecognition!");
+ Slog.w(TAG, "RemoteException in stopRecognition!", e);
}
if (code != STATUS_OK) {
dspModuleProperties =
mModelManagementService.getDspModuleProperties(mVoiceInteractionService);
} catch (RemoteException e) {
- Slog.w(TAG, "RemoteException in getDspProperties!");
+ Slog.w(TAG, "RemoteException in getDspProperties!", e);
}
// No DSP available
if (dspModuleProperties == null) {
return mModelManagementService.isEnrolledForKeyphrase(
mVoiceInteractionService, keyphraseId);
} catch (RemoteException e) {
- Slog.w(TAG, "RemoteException in listRegisteredKeyphraseSoundModels!");
+ Slog.w(TAG, "RemoteException in listRegisteredKeyphraseSoundModels!", e);
}
return false;
}
}
+
+ /** @hide */
+ public void dump(String prefix, PrintWriter pw) {
+ synchronized (mLock) {
+ pw.print(prefix); pw.print("Text="); pw.println(mText);
+ pw.print(prefix); pw.print("Locale="); pw.println(mLocale);
+ pw.print(prefix); pw.print("Availability="); pw.println(mAvailability);
+ pw.print(prefix); pw.print("KeyphraseMetadata="); pw.println(mKeyphraseMetadata);
+ pw.print(prefix); pw.print("EnrollmentInfo="); pw.println(mKeyphraseEnrollmentInfo);
+ }
+ }
}