From 9996b09e9c37d3b6f78d5771f5aaa22a2afdd146 Mon Sep 17 00:00:00 2001 From: James Babcock Date: Thu, 30 Apr 2026 20:00:16 -0700 Subject: [PATCH] First-pass G2 microphone streaming support --- ACKNOWLEDGEMENTS | 2 + .../java/com/faceclaw/app/BleProtocol.java | 5 + .../app/FaceclawAudioPacketListener.java | 5 + .../faceclaw/app/FaceclawBleCommunicator.java | 134 ++++++++- .../app/FaceclawForegroundService.java | 1 + .../com/faceclaw/app/FaceclawLc3Decoder.java | 97 +++++++ .../faceclaw/app/FaceclawVoiceController.java | 256 ++++++++++-------- .../main/jniLibs/arm64-v8a/libfaceclaw_lc3.so | Bin 0 -> 146328 bytes .../src/main/native/faceclaw_lc3_decoder.c | 92 +++++++ app/g2/android-permissions.ts | 1 + app/g2/dashboard-controller.ts | 4 +- app/native/faceclaw-communicator.ts | 4 + app/native/voice-control.ts | 5 +- 13 files changed, 493 insertions(+), 113 deletions(-) create mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawAudioPacketListener.java create mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawLc3Decoder.java create mode 100755 App_Resources/Android/src/main/jniLibs/arm64-v8a/libfaceclaw_lc3.so create mode 100644 App_Resources/Android/src/main/native/faceclaw_lc3_decoder.c diff --git a/ACKNOWLEDGEMENTS b/ACKNOWLEDGEMENTS index 8d852af6..8fb2897b 100644 --- a/ACKNOWLEDGEMENTS +++ b/ACKNOWLEDGEMENTS @@ -5,3 +5,5 @@ to keep my room clean, so to speak. Voice wake-word detection uses sherpa-onnx: https://github.com/k2-fsa/sherpa-onnx/ and the sherpa-onnx KWS Zipformer GigaSpeech model published by the k2-fsa/sherpa community. + +G2 microphone LC3 decoding uses Google's liblc3: https://github.com/google/liblc3 diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/BleProtocol.java b/App_Resources/Android/src/main/java/com/faceclaw/app/BleProtocol.java index 58a65406..f4aa7f6f 100644 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/BleProtocol.java +++ b/App_Resources/Android/src/main/java/com/faceclaw/app/BleProtocol.java @@ -33,6 +33,7 @@ public class BleProtocol { public static final int FLAG_REQUEST = 0x20; public static final int FLAG_NOTIFY = 0x01; public static final int FLAG_NOTIFY_ALT = 0x06; + public static final int CMD_AUDIO_CONTROL = 15; public static final int EVENT_CLICK = 0; public static final int EVENT_SCROLL_TOP = 1; @@ -112,6 +113,10 @@ public class BleProtocol { return wrapEvenHub(12, magic, 14, encodeVarintField(1, 0)); } + public static byte[] buildAudioControl(int magic, boolean enable) { + return wrapEvenHub(CMD_AUDIO_CONTROL, magic, 18, encodeVarintField(1, enable ? 1 : 0)); + } + public static byte[] buildShutdown(int magic, int exitMode) { return wrapEvenHub(9, magic, 11, encodeVarintField(1, exitMode)); } diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawAudioPacketListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawAudioPacketListener.java new file mode 100644 index 00000000..16aa0702 --- /dev/null +++ b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawAudioPacketListener.java @@ -0,0 +1,5 @@ +package com.faceclaw.app; + +public interface FaceclawAudioPacketListener { + void onAudioPacket(byte[] data, String arm, long arrivalMs); +} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleCommunicator.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleCommunicator.java index c17dd70f..cae434a1 100644 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleCommunicator.java +++ b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleCommunicator.java @@ -102,6 +102,7 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { private long lastSessionReadyAtMs; private long lastEvenAppConflictAtMs; private int consecutiveAckTimeouts; + private int lastAudioControlAckMagic = 0; private final BleMagicPool magicPool = new BleMagicPool(); private int nextTransportSeq = 0x40; @@ -111,6 +112,8 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { private long lastShutdownExitAtMs = 0; private int headsetBattery = -1; private int headsetCharging = -1; + private boolean audioCaptureActive; + private volatile FaceclawAudioPacketListener audioPacketListener; private String displayedFingerprint = ""; private byte[][] displayedTileBmps = emptyTileSet(); @@ -158,6 +161,8 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { synchronized (lock) { userDisconnectRequested = true; running = false; + audioCaptureActive = false; + audioPacketListener = null; phase = "disconnecting"; status = "Disconnecting..."; lock.notifyAll(); @@ -190,6 +195,51 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { disconnect(); } + public boolean startG2AudioCapture(FaceclawAudioPacketListener listener) { + if (listener == null) { + throw new IllegalArgumentException("listener is required"); + } + int magic; + synchronized (lock) { + if (!running || !sessionReady) { + logLine("skip G2 mic enable; session not ready"); + return false; + } + audioPacketListener = listener; + magic = nextMagic(); + pendingMessages.addFirst(createAudioControlMessageLocked(true, magic)); + logLine("queue G2 mic enable"); + lock.notifyAll(); + } + interruptibleSleep.interrupt(); + return waitForAudioControlAck(magic, "enable"); + } + + public void stopG2AudioCapture() { + int magic = 0; + synchronized (lock) { + audioPacketListener = null; + audioCaptureActive = false; + clearMessagesOfKindLocked("audio-control"); + if (running && sessionReady) { + magic = nextMagic(); + pendingMessages.addFirst(createAudioControlMessageLocked(false, magic)); + logLine("queue G2 mic disable"); + lock.notifyAll(); + } + } + interruptibleSleep.interrupt(); + if (magic != 0) { + waitForAudioControlAck(magic, "disable"); + } + } + + public boolean isSessionReady() { + synchronized (lock) { + return running && sessionReady; + } + } + public void submitDashboardImage(List tileBmps, String fingerprint) { submitDashboardImage(tileBmps, fingerprint, false, -1); @@ -365,6 +415,33 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { } } + private boolean waitForAudioControlAck(int magic, String operation) { + long deadline = SystemClock.elapsedRealtime() + ACK_TIMEOUT_MS + WRITE_TIMEOUT_MS + 500; + synchronized (lock) { + while (running && sessionReady && lastAudioControlAckMagic != magic && hasPendingOrInflightMagicLocked(magic)) { + long remaining = deadline - SystemClock.elapsedRealtime(); + if (remaining <= 0) { + break; + } + try { + lock.wait(Math.min(remaining, 100)); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + break; + } + } + boolean acked = lastAudioControlAckMagic == magic; + if (!acked) { + if ("enable".equals(operation)) { + audioPacketListener = null; + audioCaptureActive = false; + } + logLine("G2 mic " + operation + " ack timeout"); + } + return acked; + } + } + @Override public void run() { @@ -404,6 +481,10 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { return; } String uuid = characteristicUuid.toLowerCase(Locale.US); + if (BleProtocol.RENDER_NOTIFY_UUID.equals(uuid)) { + handleRenderNotification(address, data); + return; + } if (!BleProtocol.NOTIFY_CHAR_UUID.equals(uuid)) { return; } @@ -430,6 +511,24 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { } } + private void handleRenderNotification(String address, byte[] data) { + FaceclawAudioPacketListener listenerToCall; + long arrivalMs = SystemClock.elapsedRealtime(); + synchronized (lock) { + lastIncomingAtMs = arrivalMs; + listenerToCall = audioCaptureActive ? audioPacketListener : null; + } + if (listenerToCall == null) { + return; + } + String arm = address.equalsIgnoreCase(leftAddress) ? "L" : address.equalsIgnoreCase(rightAddress) ? "R" : "?"; + try { + listenerToCall.onAudioPacket(Arrays.copyOf(data, data.length), arm, arrivalMs); + } catch (Throwable t) { + logLine("G2 mic packet listener failed: " + safeMessage(t)); + } + } + @Override public void onConnectionStateChange(String address, boolean connected) { synchronized (lock) { @@ -446,6 +545,8 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { fixedLayoutCreated = false; warmedUp = false; startupProbePending = false; + audioCaptureActive = false; + audioPacketListener = null; clearAllMessagesLocked("connection lost"); displayedFingerprint = ""; displayedTileBmps = emptyTileSet(); @@ -465,7 +566,7 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { setState("connecting", "Connecting to the glasses..."); try { connectArm(rightAddress, true); - connectArm(leftAddress, false); + connectArm(leftAddress, true); if (!sleepDuringConnectSettling(800)) { return; } @@ -486,6 +587,8 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { imageRetryAfterMs = 0; lastHeartbeatQueuedAtMs = 0; consecutiveAckTimeouts = 0; + lastAudioControlAckMagic = 0; + audioCaptureActive = false; } setState("connected", "Connected."); logLine("session ready"); @@ -785,6 +888,13 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { if ("heartbeat".equals(message.kind)) { return; } + if ("audio-control".equals(message.kind)) { + lastAudioControlAckMagic = message.magic; + audioCaptureActive = message.label != null && message.label.contains("enable"); + logLine(audioCaptureActive ? "G2 mic enabled" : "G2 mic disabled"); + lock.notifyAll(); + return; + } if ("battery".equals(message.kind)) { BleProtocol.BatterySnapshot snapshot = BleProtocol.parseSettingsBattery(message.ackPayload); if (snapshot != null) { @@ -1035,6 +1145,25 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { ); } + private OutboundMessage createAudioControlMessageLocked(boolean enable, int magic) { + return new OutboundMessage( + "audio-control", + enable ? "G2 mic enable" : "G2 mic disable", + BleProtocol.SID_EVENHUB, + magic, + BleProtocol.framePb( + BleProtocol.buildAudioControl(magic, enable), + BleProtocol.SID_EVENHUB, + BleProtocol.FLAG_REQUEST, + nextTransportSeq++ + ), + ACK_TIMEOUT_MS, + displayedFingerprint, + -1, + null + ); + } + private boolean shouldPollBatteryLocked(long now) { return !shutdownRequested && sessionReady @@ -1265,6 +1394,9 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { lastHeartbeatQueuedAtMs = 0; lastSessionReadyAtMs = 0; consecutiveAckTimeouts = 0; + lastAudioControlAckMagic = 0; + audioCaptureActive = false; + audioPacketListener = null; displayedFingerprint = ""; displayedTileBmps = emptyTileSet(); } diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawForegroundService.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawForegroundService.java index 74884f24..1e362444 100644 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawForegroundService.java +++ b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawForegroundService.java @@ -107,6 +107,7 @@ public class FaceclawForegroundService extends Service { private int foregroundServiceType() { int type = ServiceInfo.FOREGROUND_SERVICE_TYPE_CONNECTED_DEVICE; + // TODO: Make this depend on which audio path (G2 vs phone) is selected if (hasRecordAudioPermission()) { type |= ServiceInfo.FOREGROUND_SERVICE_TYPE_MICROPHONE; } diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawLc3Decoder.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawLc3Decoder.java new file mode 100644 index 00000000..ce9f0557 --- /dev/null +++ b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawLc3Decoder.java @@ -0,0 +1,97 @@ +package com.faceclaw.app; + +import android.util.Log; + +public class FaceclawLc3Decoder { + private static final String TAG = "FaceclawLc3"; + public static final int SAMPLE_RATE = 16000; + public static final int FRAME_US = 10000; + public static final int FRAME_BYTES = 40; + public static final int FRAMES_PER_PACKET = 5; + public static final int PACKET_BYTES = 205; + public static final int COUNTER_OFFSET = 204; + public static final int SAMPLES_PER_FRAME = 160; + public static final int SAMPLES_PER_PACKET = FRAMES_PER_PACKET * SAMPLES_PER_FRAME; + + static { + System.loadLibrary("faceclaw_lc3"); + } + + private long nativeHandle; + private int lastCounter = -1; + private long realPackets; + private long duplicatePackets; + private long missingPackets; + private long decodeErrors; + + public FaceclawLc3Decoder() { + nativeHandle = nativeCreate(FRAME_US, SAMPLE_RATE); + if (nativeHandle == 0) { + throw new IllegalStateException("Could not create LC3 decoder"); + } + } + + public synchronized int decodePacket(byte[] packet, short[] pcmOut) { + if (nativeHandle == 0) { + throw new IllegalStateException("LC3 decoder is closed"); + } + if (packet == null || packet.length != PACKET_BYTES) { + decodeErrors++; + Log.w(TAG, "unexpected G2 audio packet length=" + (packet == null ? -1 : packet.length)); + return 0; + } + if (pcmOut == null || pcmOut.length < SAMPLES_PER_PACKET) { + throw new IllegalArgumentException("pcmOut must hold " + SAMPLES_PER_PACKET + " samples"); + } + + int counter = packet[COUNTER_OFFSET] & 0xff; + if (lastCounter >= 0) { + int gap = (counter - lastCounter) & 0xff; + if (gap == 0) { + duplicatePackets++; + return 0; + } + int missing = gap - 1; + if (missing > 0) { + missingPackets += missing; + } + } + + int decoded = nativeDecodePacket(nativeHandle, packet, pcmOut); + if (decoded <= 0) { + decodeErrors++; + return 0; + } + realPackets++; + lastCounter = counter; + return decoded; + } + + public synchronized long getRealPackets() { + return realPackets; + } + + public synchronized long getDuplicatePackets() { + return duplicatePackets; + } + + public synchronized long getMissingPackets() { + return missingPackets; + } + + public synchronized long getDecodeErrors() { + return decodeErrors; + } + + public synchronized void close() { + long handle = nativeHandle; + nativeHandle = 0; + if (handle != 0) { + nativeDestroy(handle); + } + } + + private static native long nativeCreate(int frameUs, int sampleRate); + private static native int nativeDecodePacket(long handle, byte[] packet, short[] pcmOut); + private static native void nativeDestroy(long handle); +} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawVoiceController.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawVoiceController.java index 9597818a..a7a0194b 100644 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawVoiceController.java +++ b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawVoiceController.java @@ -1,25 +1,12 @@ package com.faceclaw.app; -import android.Manifest; -import android.bluetooth.BluetoothAdapter; -import android.bluetooth.BluetoothDevice; -import android.bluetooth.BluetoothManager; -import android.bluetooth.BluetoothProfile; import android.content.Context; -import android.content.pm.PackageManager; import android.content.res.AssetManager; -import android.media.AudioDeviceInfo; -import android.media.AudioFormat; -import android.media.AudioManager; -import android.media.AudioRecord; -import android.media.MediaRecorder; -import android.os.Build; import android.os.Handler; import android.os.Looper; +import android.os.SystemClock; import android.util.Log; -import androidx.core.content.ContextCompat; - import com.k2fsa.sherpa.onnx.FeatureConfig; import com.k2fsa.sherpa.onnx.KeywordSpotter; import com.k2fsa.sherpa.onnx.KeywordSpotterConfig; @@ -32,12 +19,16 @@ import java.io.File; import java.io.FileOutputStream; import java.io.IOException; import java.io.InputStream; -import java.util.Set; +import java.util.ArrayDeque; public class FaceclawVoiceController { private static final String TAG = "FaceclawVoice"; private static final int SAMPLE_RATE = 16000; private static final int FEATURE_DIM = 80; + private static final int MAX_AUDIO_QUEUE_PACKETS = 80; + private static final int EXPECTED_PACKET_INTERVAL_MS = 50; + private static final int LATE_PACKET_INTERVAL_MS = 90; + private static final int STATS_INTERVAL_MS = 5_000; private static final String ASSET_ROOT = "faceclaw-voice"; private static final String MODEL_DIR = "sherpa-onnx-kws-zipformer-gigaspeech-3.3M-2024-01-01"; private static final String[] MODEL_FILES = { @@ -51,12 +42,23 @@ public class FaceclawVoiceController { private final Context appContext; private final Handler mainHandler = new Handler(Looper.getMainLooper()); private final Object lock = new Object(); + private final Object audioQueueLock = new Object(); + private final ArrayDeque audioQueue = new ArrayDeque<>(); private volatile FaceclawVoiceControllerListener listener; + private volatile FaceclawBleCommunicator communicator; private Thread workerThread; private volatile boolean started; - private AudioRecord audioRecord; private KeywordSpotter keywordSpotter; private OnlineStream stream; + private FaceclawLc3Decoder lc3Decoder; + private long queuedPackets; + private long queueDroppedPackets; + private long decodedSamples; + private long latePackets; + private long wrongArmPackets; + private long lastPacketArrivalMs; + private long maxInterPacketMs; + private long lastStatsAtMs; public FaceclawVoiceController(Context context) { this.appContext = context.getApplicationContext(); @@ -66,18 +68,18 @@ public class FaceclawVoiceController { this.listener = listener; } + public void setCommunicator(FaceclawBleCommunicator communicator) { + this.communicator = communicator; + } + public void start() { synchronized (lock) { if (started) { emitStatus("Voice control is already listening."); return; } - if (!hasRecordAudioPermission()) { - emitStatus("Voice control needs microphone permission."); - return; - } - if (!hasBluetoothHeadset()) { - emitStatus("Voice control needs a paired Bluetooth headset."); + if (communicator == null || !communicator.isSessionReady()) { + emitStatus("Voice control needs an active G2 connection."); return; } started = true; @@ -95,7 +97,10 @@ public class FaceclawVoiceController { started = false; threadToJoin = workerThread; } - stopAudio(); + stopG2Audio(); + synchronized (audioQueueLock) { + audioQueueLock.notifyAll(); + } if (threadToJoin != null) { threadToJoin.interrupt(); } @@ -111,19 +116,21 @@ public class FaceclawVoiceController { File modelDir = installModelFiles(); keywordSpotter = new KeywordSpotter(buildConfig(modelDir)); stream = keywordSpotter.createStream(); - if (!startAudio()) { - emitStatus("Voice control could not start microphone input."); + lc3Decoder = new FaceclawLc3Decoder(); + if (!startG2Audio()) { + emitStatus("Voice control could not start G2 microphone input."); return; } - emitStatus("Voice control listening for \"screen on\"."); - processAudio(); + emitStatus("Voice control listening for \"screen on\" from the G2 mic."); + processG2Audio(); } catch (Throwable error) { Log.e(TAG, "Voice control failed", error); emitStatus("Voice control failed: " + error.getMessage()); } finally { + stopG2Audio(); releaseSherpa(); - stopAudio(); + releaseLc3(); synchronized (lock) { started = false; workerThread = null; @@ -183,53 +190,42 @@ public class FaceclawVoiceController { } } - private boolean startAudio() { - routeToBluetoothHeadset(); - int minBufferBytes = AudioRecord.getMinBufferSize( - SAMPLE_RATE, - AudioFormat.CHANNEL_IN_MONO, - AudioFormat.ENCODING_PCM_16BIT - ); - if (minBufferBytes <= 0) { + private boolean startG2Audio() { + FaceclawBleCommunicator currentCommunicator = communicator; + if (currentCommunicator == null) { return false; } - if (!hasRecordAudioPermission()) { - return false; + resetAudioStats(); + synchronized (audioQueueLock) { + audioQueue.clear(); } - audioRecord = new AudioRecord( - MediaRecorder.AudioSource.VOICE_RECOGNITION, - SAMPLE_RATE, - AudioFormat.CHANNEL_IN_MONO, - AudioFormat.ENCODING_PCM_16BIT, - minBufferBytes * 2 - ); - if (audioRecord.getState() != AudioRecord.STATE_INITIALIZED) { - audioRecord.release(); - audioRecord = null; - return false; - } - audioRecord.startRecording(); - return true; + return currentCommunicator.startG2AudioCapture(this::queueAudioPacket); } - private void processAudio() { - short[] buffer = new short[SAMPLE_RATE / 10]; + private void processG2Audio() { + short[] pcm = new short[FaceclawLc3Decoder.SAMPLES_PER_PACKET]; while (started && !Thread.currentThread().isInterrupted()) { - AudioRecord currentAudio = audioRecord; OnlineStream currentStream = stream; KeywordSpotter currentSpotter = keywordSpotter; - if (currentAudio == null || currentStream == null || currentSpotter == null) { + FaceclawLc3Decoder currentDecoder = lc3Decoder; + if (currentStream == null || currentSpotter == null || currentDecoder == null) { return; } - int count = currentAudio.read(buffer, 0, buffer.length); - if (count <= 0) { + AudioPacket packet = takeAudioPacket(); + if (packet == null) { continue; } + int count = currentDecoder.decodePacket(packet.data, pcm); + if (count <= 0) { + maybeEmitAudioStats(false); + continue; + } + decodedSamples += count; float[] samples = new float[count]; for (int i = 0; i < count; i++) { - samples[i] = buffer[i] / 32768.0f; + samples[i] = pcm[i] / 32768.0f; } currentStream.acceptWaveform(samples, SAMPLE_RATE); @@ -242,27 +238,16 @@ public class FaceclawVoiceController { emitWakeWord(keyword); } } + maybeEmitAudioStats(false); } } - private void stopAudio() { - AudioRecord record = audioRecord; - audioRecord = null; - if (record != null) { - try { - record.stop(); - } catch (IllegalStateException ignored) { - } - record.release(); - } - AudioManager audioManager = (AudioManager) appContext.getSystemService(Context.AUDIO_SERVICE); - if (audioManager != null) { - if (Build.VERSION.SDK_INT >= 31) { - audioManager.clearCommunicationDevice(); - } - audioManager.stopBluetoothSco(); - audioManager.setBluetoothScoOn(false); + private void stopG2Audio() { + FaceclawBleCommunicator currentCommunicator = communicator; + if (currentCommunicator != null) { + currentCommunicator.stopG2AudioCapture(); } + maybeEmitAudioStats(true); } private void releaseSherpa() { @@ -276,51 +261,90 @@ public class FaceclawVoiceController { } } - private void routeToBluetoothHeadset() { - AudioManager audioManager = (AudioManager) appContext.getSystemService(Context.AUDIO_SERVICE); - if (audioManager == null) { + private void releaseLc3() { + if (lc3Decoder != null) { + lc3Decoder.close(); + lc3Decoder = null; + } + } + + private void queueAudioPacket(byte[] data, String arm, long arrivalMs) { + if (!started || data == null) { return; } - audioManager.setMode(AudioManager.MODE_IN_COMMUNICATION); - audioManager.startBluetoothSco(); - audioManager.setBluetoothScoOn(true); - if (Build.VERSION.SDK_INT >= 31) { - for (AudioDeviceInfo device : audioManager.getAvailableCommunicationDevices()) { - if (device.getType() == AudioDeviceInfo.TYPE_BLUETOOTH_SCO - || device.getType() == AudioDeviceInfo.TYPE_BLE_HEADSET) { - audioManager.setCommunicationDevice(device); - return; + if (!"L".equals(arm)) { + wrongArmPackets++; + } + synchronized (audioQueueLock) { + if (audioQueue.size() >= MAX_AUDIO_QUEUE_PACKETS) { + audioQueue.removeFirst(); + queueDroppedPackets++; + } + audioQueue.addLast(new AudioPacket(data, arm, arrivalMs)); + queuedPackets++; + if (lastPacketArrivalMs > 0) { + long delta = arrivalMs - lastPacketArrivalMs; + if (delta > maxInterPacketMs) { + maxInterPacketMs = delta; + } + if (delta > LATE_PACKET_INTERVAL_MS) { + latePackets++; } } + lastPacketArrivalMs = arrivalMs; + audioQueueLock.notifyAll(); } } - private boolean hasBluetoothHeadset() { - if (Build.VERSION.SDK_INT >= 31 - && ContextCompat.checkSelfPermission(appContext, Manifest.permission.BLUETOOTH_CONNECT) - != PackageManager.PERMISSION_GRANTED) { - return false; - } - BluetoothManager manager = (BluetoothManager) appContext.getSystemService(Context.BLUETOOTH_SERVICE); - BluetoothAdapter adapter = manager == null ? null : manager.getAdapter(); - if (adapter == null) { - return false; - } - try { - int state = adapter.getProfileConnectionState(BluetoothProfile.HEADSET); - if (state == BluetoothProfile.STATE_CONNECTED || state == BluetoothProfile.STATE_CONNECTING) { - return true; + private AudioPacket takeAudioPacket() { + synchronized (audioQueueLock) { + while (started && audioQueue.isEmpty()) { + try { + audioQueueLock.wait(250); + maybeEmitAudioStats(false); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + return null; + } } - Set bondedDevices = adapter.getBondedDevices(); - return bondedDevices != null && !bondedDevices.isEmpty(); - } catch (SecurityException ignored) { - return false; + return audioQueue.pollFirst(); } } - private boolean hasRecordAudioPermission() { - return ContextCompat.checkSelfPermission(appContext, Manifest.permission.RECORD_AUDIO) - == PackageManager.PERMISSION_GRANTED; + private void resetAudioStats() { + queuedPackets = 0; + queueDroppedPackets = 0; + decodedSamples = 0; + latePackets = 0; + wrongArmPackets = 0; + lastPacketArrivalMs = 0; + maxInterPacketMs = 0; + lastStatsAtMs = SystemClock.elapsedRealtime(); + } + + private void maybeEmitAudioStats(boolean force) { + long now = SystemClock.elapsedRealtime(); + if (!force && now - lastStatsAtMs < STATS_INTERVAL_MS) { + return; + } + lastStatsAtMs = now; + FaceclawLc3Decoder currentDecoder = lc3Decoder; + long real = currentDecoder == null ? 0 : currentDecoder.getRealPackets(); + long duplicate = currentDecoder == null ? 0 : currentDecoder.getDuplicatePackets(); + long missing = currentDecoder == null ? 0 : currentDecoder.getMissingPackets(); + long decodeErrors = currentDecoder == null ? 0 : currentDecoder.getDecodeErrors(); + String status = "G2 mic packets=" + queuedPackets + + " decoded=" + real + + " missing=" + missing + + " duplicate=" + duplicate + + " late=" + latePackets + + " maxGapMs=" + maxInterPacketMs + + " queueDrop=" + queueDroppedPackets + + " decodeErrors=" + decodeErrors + + " wrongArm=" + wrongArmPackets + + " audioSec=" + String.format(java.util.Locale.US, "%.1f", decodedSamples / (double) SAMPLE_RATE); + Log.i(TAG, status + " expectedIntervalMs=" + EXPECTED_PACKET_INTERVAL_MS); + emitStatus(status); } private void emitStatus(String status) { @@ -338,4 +362,16 @@ public class FaceclawVoiceController { } mainHandler.post(() -> currentListener.onWakeWord(keyword)); } + + private static final class AudioPacket { + final byte[] data; + final String arm; + final long arrivalMs; + + AudioPacket(byte[] data, String arm, long arrivalMs) { + this.data = data; + this.arm = arm == null ? "?" : arm; + this.arrivalMs = arrivalMs; + } + } } diff --git a/App_Resources/Android/src/main/jniLibs/arm64-v8a/libfaceclaw_lc3.so b/App_Resources/Android/src/main/jniLibs/arm64-v8a/libfaceclaw_lc3.so new file mode 100755 index 0000000000000000000000000000000000000000..b9eee4f3705327a52faa5632aa4a4e2dca164182 GIT binary patch literal 146328 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�E7xq8bB$VNXU54ZnC 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

wfGUrI~Z{f{{1^% zq4V4}bbg<38L#df?u-8mf1*G8!++}!f50Dp*dLyJqc8qSfB2XF@EU*k5`Xx4!UgZM zZSWfD|AN<$?}JnBkKf)OzQi9M7_Ykd!>zaY;&1oIPw|Hz^oP&&hYu!P2`aBYSV`By zucUL97Jen2ZzB9^bRMn6k5ER8@#QA~zkqNlZ;ijaY5orr2$%ByFx40TFIsvclyI)ktaxbm;2$I@WV+a zT=2RE`U2Mb!?XPHAGps4AW*J5{qYa`;{#OtmHOi^_T#ns;Zz3V5B3EF^7*7c{zub& z@B{Q*=MR5ihA;fAAO3Ir;XkyAztbPy-5);y2U`bPc}KMg{~O`b4g>AMpG^fF5Pn7_ zP+x&?^v<;KKzj&;qbI`e%65BN3%|16vZs92c8mRXei2IX{r-v)ul$e~Nqzm{0bh8U zUqBS1$&rl8`o6wsfq!%`_+6QwC@uWT{InF?Ol_{P9)tEB&v)4*su7q8840;?I8|yq6Y!WjpDu zge-SOKf0!Q7hoa_QFN{a>CBv5$xefX^%5@g6`*=9pz zP=G}WnVt9E*zd{jYiH)IZBUB^Nm$ZCt&l>pP-Kw`t)dW_3Y4fsV8H?lEUAGAtv~@M zd_}N@RZ7||-BQlE=YQtCxo^A(F_PcR{N{hpJ@;eo+%$RpsKAbLkZiSZNblpijD_tLi z{dk{Rmi32-bA6jdeH+E$2duu&HPi{Kr}Fx$kaIZj80;K&?3{*v{FDec(e7MnT7xK4HxUrx}(1n`UBFjH=1wvL%-qZAB2ADaWTA!Y~uNUPVc6pe;oRe zZ;5^l{yYu+mZSeq=ubeuh3fu%YLD6eIY<8@%P%v>z9WWbp#N*=&E?{t)}QO3KlOy@ z`Fh67EcBy}-dFo)M7M(U_Mjhk^zVUw2!KuZ23;pb@W$5f9NOBlU-h3 z1O1AlKcM!{icag#ZP2ee`UdnTWT0o(?D=WT-$K9U=u;@ksF1dKs|XF ze0{(0S=5IwfSa3y>;0rn@bmN{2`_6@UwL^7{63kWpnte4{8{j0JP|?52(3H;LcruqBT{vBz49DK)}Y5pMi=v`_4Iq==@OY_s=U%f{- zvd8>C_d%pm+a}a#R;kSdYI{XOun#1n^Uw1ft z+s*p9;qV8+Hy!?Y@GXab8~hyj7}E7q@R8#Jl>Y{N+~GU_RQ#E8_)EcO!N+004BmD4 zP2j5zza4zt;UV}Y_yp|V1#UhnK>2a-35P!ne%Rq(1YZT$^8GIOn!|q%zV7hff^RsS zKcK_)ZPVdbfp0ndTJUoYzXjZUOwy}F`VbO!DU(xR&D!!N>nOUB3LmDbCMXhrbql#o_#qGqc81ZzG=7 zFMWsA?=TZjp@BqtE3iNIzXJAvuYj9t1&o8=1Ad*O|0MW<--uAl@g#8`7b}Mu^EK!X zIr^W0*B$=+osvIG;8()XRp9qJd>{C_W2XYX;qVpkO^2_6Z#nkA0Di&YPZH<(fpfTy zYkHryoEqgp=(T)*x{dx9(4WM7{smO) ztEu8$LF2(0*g1v%PXT-b^Yat%rva|>_8&w4WC>j7)vts7_ko|fTEIH&+z-BVjc{D% z%?WVxa^W+u{|NZZtA+mq?3@Na4X*v1E%1#A(a*}tJO@6CdHCC4XXJ9p2c4g%XV~rX zLhwh60yLlLon)JDPk`SHJFfvB$NV2|65(m+9|CXg75)tPm%(qH60ZJ#5Bv3Re7W2k7V ze>?c@>&1@dPYe94!~YKapaqF+YTD@ zGVtAB7yEj?OoE&L7Ji4U%zp6hrv>PI{@cJ0!OwdoTGIfpeM9u;Fiu5+r1Bf zPaF`g^U|LH*ZI;h*k32k^<>qlC!d4<*6)a&du3(534RCPprPe9w0l1QKkymhKSq7{ z75G`C>mkJZC%Yw|pLs&`2T;D3gO@OmdLQ(Az%RT@^rOg!N$@?;Q!{0k8^O;%D|!Pz z4}qIc39qA`EP(I0U3dxO-**$g-0U)E_$>!ow(PGl9{@k^v@;*Ib|4y9eFF9mARpAv z&%(~3tJC(s2tIX9n*Tev&azI(Q?b==G(m-o@Ghxc%kgp{irVLm`E5jeGZDPZj&s9othu}CKuGbxzKL~ zUcE+2-7~p3SR$2`vXE_17?Yc8v>TouhW@g(@3$INin2pm`swQpKRwg3K9j?-Uop9; z9>t+-$=X!IxDw1a+FsPjRgLF$+Fq?$ZFZu->{-g?iPWNwSEoE^241z(j^dQaYx*%M zYq1ZHk^MR^3Rj}BR(PACf+LAlz3r5yJp(81y3`Uw=2Cyv*xvXtx6D@ zIlmgvb3}_?vs(0OLA6s0LUNpZo!}_*{8KP~9M^()nA5?csWjqf_)ujLA=p2gbdJGN zFYL8*mBq-ToNERq&6}AtQG0t^HZKZJu)ZKa(PF0u^Dbxy;rufDm^fpTWn~n-de5E& zZO(&Sv*Xtc|9DZpjEzDm+3->DWu^c{Uz&YFhoT zd%Ef5hesulWR4dHl&hSF1FSr_Gc~xAx98(v8Bsyu%xu-F$*D0n7Z02^wlKTRs+MKH zn4`8mWo&h{Wxqsc88t869-ZJ()u-~NGm~mkl$#H5M)cZ8dVV|Rl8w6b#9rt(y{PVY z8|`^RF67Hz%htnSsau%K1>2j;TgQtR5ln4=tZ)%O3+3&@6>WPm*qBjn?6oP;?BUa| zR-sZW=VH@Otv654D&`tTkPVtkZEknm%(kUso0TMgsYtwdu~DN2H}dENv4y}*dAHM} zR=7cDkl)OeN+u;NP1@!@twGC^66Pl|gypm`O8anxd()cfEX`C}Q^?Xxr#0ma&E!N{ zlb^~G<St=7ZKeR*OaZo; z0x6pu$zUA3pR&myWs^b5CIhzVp43BtuIjFa+W8?=97d&Kl+hxUhgExr(bO=S9!6OW zSw6#mx)cs2AfJ%}y2=deGSWcZt6^P6D)Jf0$Y-P@>*Oe8q=PPGL-7_e(m@@!VO>T# z=;Al5%ScBdBOQf|bYxvLiW%uBW~8H-k&a?UI*J+TC}yOin30ZRMmmZa>Bwq}N*U=W zWu&8Id+|jROLvI}C3^X9cB|A84(8^fT+^TTs8y?V7LE3hys(<14nsX0>_=GEXdlh8 z5%nszwP{zRgOCx8N){^@GZ00;=lI1B&uwd*8y)g)8^`$Q_LlkR#T>K8FCLs6qn^{y zu+;PRzxj1V5dt(8PI6UkLNn!0v$_CC8R&DHaGc4eX1NS?nBGymMnYw zv2$~^xK9SUUfYiwM}r&4Gz|o7_Y()~_=&pV%}&+wD2RJq9Uq&yFbMw8NF>Txzq$|% z4j2D$Gc@DSS+-8esGLXB13ubbF(+j{h&|r%ngI<;m{jXQm4^S^ZRXv%W-qGucWLM$ z`gtBM(-a76{3;a-b&)B*+nrFx7l~mMn`U>%2Ww4>9p0LuOI5BdNt)yXJ z?dpxk*W`l*N1|1@AOOnmQ$0&fzPK2JVpPZy2Kq9HEIAU5s zi-1jk`anOpJ=mm42bx>*o69s;MS)tKqmtpaYfGoyq94+f2*qiY^a0sq_J&5Y5|U1L z7Ep7Y+UMcwFyL~JXc8+4!oW^qu?@DF0yfqZv1TQi)`rbcJA>8FpCmglw`GMiB zuC#-sf>?`OM^k<=Ncoil)~^(?RwTY8y8bMKMK(|AQbh0WN&4BPs7E1b!cMc$3Bx(! zARBiUtJ2)6wPO`kI%l{@t6gb05|{g@qK;qs-q97+?xaS$mAPUTl-W3TusK()SOxFY z2X~Ghu>*NIz4&OWOQ=H^@Bj@GL(a&)S6q?Og!48IsR?LyIt#t7M5Qcg+7eZZ=JJ}U zGn&s-k7@-CFKl3rq7%}rr#GPO!^9*b>2J6~P^K!_(6S{qXv}pst_6eFDDS&2j1dhcVjb-Qsc zjoS^0f2z~ +#include +#include + +#include "lc3.h" + +#define G2_FRAME_BYTES 40 +#define G2_FRAMES_PER_PACKET 5 +#define G2_SAMPLES_PER_PACKET 800 + +typedef struct { + void *mem; + lc3_decoder_t decoder; +} faceclaw_lc3_decoder_t; + +JNIEXPORT jlong JNICALL +Java_com_faceclaw_app_FaceclawLc3Decoder_nativeCreate(JNIEnv *env, jclass clazz, jint frame_us, jint sample_rate) { + (void) env; + (void) clazz; + unsigned mem_size = lc3_decoder_size(frame_us, sample_rate); + if (mem_size == 0) { + return 0; + } + + faceclaw_lc3_decoder_t *state = (faceclaw_lc3_decoder_t *) calloc(1, sizeof(faceclaw_lc3_decoder_t)); + if (state == NULL) { + return 0; + } + state->mem = calloc(1, mem_size); + if (state->mem == NULL) { + free(state); + return 0; + } + state->decoder = lc3_setup_decoder(frame_us, sample_rate, 0, state->mem); + if (state->decoder == NULL) { + free(state->mem); + free(state); + return 0; + } + return (jlong) (uintptr_t) state; +} + +JNIEXPORT jint JNICALL +Java_com_faceclaw_app_FaceclawLc3Decoder_nativeDecodePacket(JNIEnv *env, jclass clazz, jlong handle, jbyteArray packet, jshortArray pcm_out) { + (void) clazz; + faceclaw_lc3_decoder_t *state = (faceclaw_lc3_decoder_t *) (uintptr_t) handle; + if (state == NULL || state->decoder == NULL || packet == NULL || pcm_out == NULL) { + return 0; + } + if ((*env)->GetArrayLength(env, packet) < 205 || (*env)->GetArrayLength(env, pcm_out) < G2_SAMPLES_PER_PACKET) { + return 0; + } + + jbyte *packet_bytes = (*env)->GetByteArrayElements(env, packet, NULL); + jshort *pcm = (*env)->GetShortArrayElements(env, pcm_out, NULL); + if (packet_bytes == NULL || pcm == NULL) { + if (packet_bytes != NULL) { + (*env)->ReleaseByteArrayElements(env, packet, packet_bytes, JNI_ABORT); + } + if (pcm != NULL) { + (*env)->ReleaseShortArrayElements(env, pcm_out, pcm, JNI_ABORT); + } + return 0; + } + + int ok = 1; + for (int frame = 0; frame < G2_FRAMES_PER_PACKET; frame++) { + const uint8_t *lc3_frame = (const uint8_t *) packet_bytes + frame * G2_FRAME_BYTES; + int16_t *pcm_frame = (int16_t *) pcm + frame * 160; + int rc = lc3_decode(state->decoder, lc3_frame, G2_FRAME_BYTES, LC3_PCM_FORMAT_S16, pcm_frame, 1); + if (rc < 0) { + ok = 0; + break; + } + } + + (*env)->ReleaseByteArrayElements(env, packet, packet_bytes, JNI_ABORT); + (*env)->ReleaseShortArrayElements(env, pcm_out, pcm, ok ? 0 : JNI_ABORT); + return ok ? G2_SAMPLES_PER_PACKET : 0; +} + +JNIEXPORT void JNICALL +Java_com_faceclaw_app_FaceclawLc3Decoder_nativeDestroy(JNIEnv *env, jclass clazz, jlong handle) { + (void) env; + (void) clazz; + faceclaw_lc3_decoder_t *state = (faceclaw_lc3_decoder_t *) (uintptr_t) handle; + if (state == NULL) { + return; + } + free(state->mem); + free(state); +} diff --git a/app/g2/android-permissions.ts b/app/g2/android-permissions.ts index c58d2247..77ab680f 100644 --- a/app/g2/android-permissions.ts +++ b/app/g2/android-permissions.ts @@ -100,3 +100,4 @@ export async function ensureBlePermissions(): Promise { export async function ensureVoicePermissions(): Promise { await ensurePermissions([RECORD_AUDIO_PERMISSION], VOICE_PERMISSION_REQUEST_CODE, "Voice control"); } + diff --git a/app/g2/dashboard-controller.ts b/app/g2/dashboard-controller.ts index 323165ca..7122082a 100644 --- a/app/g2/dashboard-controller.ts +++ b/app/g2/dashboard-controller.ts @@ -487,6 +487,8 @@ class DashboardController { private async setVoiceControlEnabled(enabled: boolean): Promise { if (enabled) { try { + // Treat Android mic permission as the consent gate for voice control, + // even when the current source is the G2 mic over BLE. await ensureVoicePermissions(); } catch (error) { this.appendLog(`voice control permission failed: ${this.formatError(error)}`); @@ -671,7 +673,7 @@ class DashboardController { if (!this.communicator) return; if (!isDashboardVoiceControlEnabled()) return; this.updateConnectedForegroundNotification(); - voiceControlBridge.start(); + voiceControlBridge.start(this.communicator.getNativeCommunicator()); } private setStopwatchRenderActive(active: boolean): void { diff --git a/app/native/faceclaw-communicator.ts b/app/native/faceclaw-communicator.ts index 2d841bcd..cf283a81 100644 --- a/app/native/faceclaw-communicator.ts +++ b/app/native/faceclaw-communicator.ts @@ -216,6 +216,10 @@ export class FaceclawCommunicatorBridge { return () => this.frameMetricsListeners.delete(listener); } + getNativeCommunicator(): any { + return this.communicator; + } + waitForNextFrameMetrics(timeoutMs: number): Promise { const delayMs = Math.max(1, Math.round(nonNegativeNumber(timeoutMs))); return new Promise((resolve) => { diff --git a/app/native/voice-control.ts b/app/native/voice-control.ts index 91b190ae..db5e3a62 100644 --- a/app/native/voice-control.ts +++ b/app/native/voice-control.ts @@ -25,9 +25,12 @@ export class FaceclawVoiceControlBridge { return () => this.wakeWordListeners.delete(listener); } - start(): void { + start(communicator?: any): void { if (this.started || !global.isAndroid) return; this.ensureController(); + if (communicator) { + this.controller?.setCommunicator(communicator); + } this.started = true; this.controller?.start(); }