macOS companion app

Sesle uyandırma (macOS)

Sesle Uyandırma ve Bas-Konuş

Gereksinimler

Sesle Uyandırma ve bas-konuş için macOS 26 veya daha yeni bir sürüm gerekir. Daha eski macOS sürümlerinde denetimler Ses ayarları sayfasında gizlenir ve bunun yerine macOS 26 gereksinimi gösterilir.

Modlar

Uyandırma sözcüğü modu (varsayılan): Her zaman açık bir Konuşma tanıyıcı, tetikleyici belirteçleri (swabbleTriggerWords) bekler. Eşleşme olduğunda yakalamayı başlatır, kısmi metni içeren katmanı gösterir ve sessizlikten sonra otomatik olarak gönderir.
Bas-konuş (sağ Option tuşunu basılı tutun): Tetikleyici gerekmeksizin hemen yakalamak için sağ Option tuşunu basılı tutun. Katman, tuş basılı tutulduğu sürece görünür; tuş bırakıldığında metni düzenleyebilmeniz için kısa bir gecikmenin ardından yakalama sonlandırılır ve iletilir.

Çalışma zamanı davranışı (uyandırma sözcüğü)

Tanıyıcı VoiceWakeRuntime içinde bulunur.
Tetikleyici yalnızca uyandırma sözcüğü ile sonraki sözcük arasında anlamlı bir duraklama olduğunda çalışır (triggerPauseWindow = 0,55 sn). Katman/zil sesi, komut başlamadan önce bile duraklama sırasında başlayabilir.
Sessizlik aralıkları: konuşma sürerken 2,0 sn (silenceWindow), yalnızca tetikleyici duyulduysa 5,0 sn (triggerOnlySilenceWindow).
Kesin durdurma: kontrolden çıkan oturumları önlemek için 120 sn (captureHardStop).
Oturumlar arası geri tepme önleme: gönderimden sonra 350 ms (debounceAfterSend).
Katman, kesinleşmiş/geçici metin renklendirmesiyle VoiceWakeOverlayController üzerinden yönetilir.
Gönderimden sonra tanıyıcı, sonraki tetikleyiciyi dinlemek üzere temiz biçimde yeniden başlatılır.

Yaşam döngüsü değişmezleri

Sesle Uyandırma etkinse ve izinler verilmişse uyandırma sözcüğü tanıyıcısı, etkin bir bas-konuş yakalaması dışında dinlemeyi sürdürür.
X düğmesiyle elle kapatma dâhil olmak üzere katmanın kapatılması, tanıyıcıyı her zaman devam ettirir: VoiceSessionCoordinator.overlayDidDismiss, tüm kapatma yollarında VoiceWakeRuntime.refresh(state:) çağrısını yapar. Oturum/belirteç modeli için Ses katmanı bölümüne bakın.

Bas-konuş ayrıntıları

Kısayol tuşu algılama, sağ Option için (keyCode 61 + .option) genel bir .flagsChanged izleyicisi kullanır. Yalnızca olayları gözlemler, hiçbir zaman engellemez.
Yakalama VoicePushToTalk içinde gerçekleşir: Konuşma'yı hemen başlatır, kısmi sonuçları katmana aktarır ve tuş bırakıldığında VoiceWakeForwarder çağrısını yapar.
Bas-konuşun başlatılması, çakışan ses dinleyicilerini önlemek için uyandırma sözcüğü çalışma zamanını duraklatır; tuş bırakıldıktan sonra otomatik olarak yeniden başlatılır.
İzinler: Mikrofon + Konuşma gerekir; tuş olaylarını almak için Erişilebilirlik/Giriş İzleme onayı gerekir.
Harici klavyeler: Bazıları sağ Option tuşunu beklendiği gibi sunmaz. Kullanıcılar algılama sorunları bildirirse yedek bir kısayol sunun.

Kullanıcıya yönelik ayarlar

Sesle Uyandırma anahtarı: uyandırma sözcüğü çalışma zamanını etkinleştirir.
Konuşmak için sağ Option tuşunu basılı tutun: bas-konuş izleyicisini etkinleştirir.
Dil ve mikrofon seçicileri, canlı seviye ölçer, tetikleyici sözcük tablosu ve sınayıcı (yalnızca yerel, hiçbir zaman iletmez).
Mikrofon seçici, bir aygıtın bağlantısı kesilirse son seçimi korur, bağlantının kesildiğine ilişkin bir ipucu gösterir ve aygıt geri dönene kadar geçici olarak sistem varsayılanına geçer.
Sesler: tetikleyici algılandığında ve gönderimde zil sesi çalar; varsayılan olarak macOS "Glass" sistem sesi kullanılır. Her olay için NSSound tarafından yüklenebilen herhangi bir dosyayı (ör. MP3/WAV/AIFF) seçin veya Ses Yok seçeneğini belirleyin.

İletme davranışı

İletme sırasında VoiceWakeForwarder.selectedSessionOptions, ayarlanmışsa etkin WebChat oturum anahtarını, aksi takdirde Gateway'in ana oturum anahtarını seçer.
Bu oturumu sessions.list aracılığıyla arar ve teslimat kanalını ve hedefi oturumun teslimat bağlamından türetir (önce son kanalına/hedefine, ardından ayrıştırılmış bir oturum anahtarına geri döner); hiçbir şey çözümlenemezse varsayılan olarak WebChat'i kullanır.
Teslimat başarısız olursa hata günlüğe kaydedilir (voicewake.forward kategorisi) ve çalıştırma WebChat/oturum günlükleri üzerinden yine de görülebilir.

İletme yükü

VoiceWakeForwarder.prefixedTranscript(_:), dökümden önce makine ipucu satırı (çözümlenmiş ana makine adı; çözümlenemezse "bu Mac") ekler; bu davranış uyandırma sözcüğü ve bas-konuş yolları arasında ortaktır.

Hızlı doğrulama

Bas-konuşu açın, sağ Option tuşunu basılı tutun, konuşun ve bırakın: katman önce kısmi sonuçları göstermeli, ardından göndermelidir.
Tuşu basılı tutarken menü çubuğundaki kulaklar büyütülmüş durumda kalmalıdır (triggerVoiceEars(ttl: nil)); tuş bırakıldıktan sonra küçülürler.

İlgili

Was this useful?