> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Sesle uyandırma (macOS)

# Sesle Uyandırma ve Bas-Konuş

## Gereksinimler

Sesle Uyandırma ve bas-konuş macOS 26 veya daha yenisini gerektirir. Daha eski macOS sürümlerinde,
denetimler Voice ayarları sayfasından gizlenir ve bu sayfada macOS 26
gereksinimi gösterilir.

## Modlar

* **Uyandırma sözcüğü modu** (varsayılan): her zaman açık Speech tanıyıcısı tetikleyici belirteçleri (`swabbleTriggerWords`) bekler. Eşleşme olduğunda yakalamayı başlatır, kısmi metinle bindirmeyi gösterir ve sessizlikten sonra otomatik gönderir.
* **Bas-konuş (sağ Option basılı tutma)**: hemen yakalamak için sağ Option tuşunu basılı tutun; tetikleyici gerekmez. Basılı tutulurken bindirme görünür; bırakmak, metni ayarlayabilmeniz için kısa bir gecikmeden sonra sonlandırır ve iletir.

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

* Speech tanıyıcısı `VoiceWakeRuntime` içinde yaşar.
* Tetikleyici yalnızca uyandırma sözcüğü ile sonraki sözcük arasında **anlamlı bir duraklama** olduğunda çalışır (\~0,55 sn boşluk). Bindirme/sesli uyarı, komut başlamadan önce bile duraklamada başlayabilir.
* Sessizlik pencereleri: konuşma akıyorsa 2,0 sn, yalnızca tetikleyici duyulduysa 5,0 sn.
* Kesin durdurma: kontrolden çıkan oturumları önlemek için 120 sn.
* Oturumlar arası debounce: 350 ms.
* Bindirme, kesinleşmiş/geçici renklendirme ile `VoiceWakeOverlayController` üzerinden yönetilir.
* Gönderimden sonra tanıyıcı, sonraki tetikleyiciyi dinlemek için temiz biçimde yeniden başlar.

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

* Sesle Uyandırma etkinse ve izinler verilmişse, uyandırma sözcüğü tanıyıcısı dinliyor olmalıdır (açık bir bas-konuş yakalaması sırası hariç).
* Bindirme görünürlüğü (X düğmesiyle elle kapatma dahil) tanıyıcının sürdürülmesini asla engellememelidir.

## Yapışkan bindirme hata modu (önceki)

Önceden, bindirme görünür halde takılı kalırsa ve elle kapatırsanız, Voice Wake "ölü" görünebilirdi; çünkü çalışma zamanının yeniden başlatma girişimi bindirme görünürlüğü tarafından engellenebilir ve sonraki yeniden başlatma zamanlanmayabilirdi.

Sağlamlaştırma:

* Uyandırma çalışma zamanı yeniden başlatması artık bindirme görünürlüğü tarafından engellenmez.
* Bindirme kapatma tamamlanması, `VoiceSessionCoordinator` üzerinden bir `VoiceWakeRuntime.refresh(...)` tetikler; bu nedenle X ile elle kapatma her zaman dinlemeyi sürdürür.

## Bas-konuş ayrıntıları

* Kısayol algılama, **sağ Option** (`keyCode 61` + `.option`) için genel bir `.flagsChanged` izleyicisi kullanır. Yalnızca olayları gözlemleriz (yutma yok).
* Yakalama hattı `VoicePushToTalk` içindedir: Speech'i hemen başlatır, kısmi sonuçları bindirmeye akıtır ve bırakmada `VoiceWakeForwarder` çağırır.
* Bas-konuş başladığında, rakip ses tap'lerini önlemek için uyandırma sözcüğü çalışma zamanını duraklatırız; bırakmadan sonra otomatik olarak yeniden başlar.
* İzinler: Mikrofon + Speech gerektirir; olayları görmek Erişilebilirlik/Giriş İzleme onayı gerektirir.
* Harici klavyeler: bazıları sağ Option tuşunu beklendiği gibi sunmayabilir; kullanıcılar kaçırılan algılamalar bildirirse bir yedek kısayol sunun.

## Kullanıcıya dönük ayarlar

* **Voice Wake** anahtarı: uyandırma sözcüğü çalışma zamanını etkinleştirir.
* **Konuşmak için Sağ Option'ı basılı tut**: bas-konuş izleyicisini etkinleştirir.
* Dil ve mikrofon seçiciler, canlı seviye ölçer, tetikleyici sözcük tablosu, test aracı (yalnızca yerel; iletmez).
* Mikrofon seçici, bir aygıtın bağlantısı kesilirse son seçimi korur, bağlantı kesildi ipucu gösterir ve aygıt geri dönene kadar geçici olarak sistem varsayılanına döner.
* **Sesler**: tetikleyici algılandığında ve gönderimde sesli uyarılar; varsayılan olarak macOS "Glass" sistem sesi kullanılır. Her olay için herhangi bir `NSSound` tarafından yüklenebilir dosya (örn. MP3/WAV/AIFF) seçebilir veya **Ses Yok** seçebilirsiniz.

## İletme davranışı

* Voice Wake etkin olduğunda, dökümler etkin gateway/agent'a iletilir (Mac uygulamasının geri kalanıyla aynı yerel ve uzak mod).
* Yanıtlar **son kullanılan ana sağlayıcıya** (WhatsApp/Telegram/Discord/WebChat) teslim edilir. Teslimat başarısız olursa hata günlüğe kaydedilir ve çalıştırma WebChat/oturum günlükleri üzerinden hâlâ görünür olur.

## İletme yükü

* `VoiceWakeForwarder.prefixedTranscript(_:)`, göndermeden önce makine ipucunu başa ekler. Uyandırma sözcüğü ve bas-konuş yolları arasında paylaşılır.

## Hızlı doğrulama

* Bas-konuşu açın, sağ Option'ı basılı tutun, konuşun, bırakın: bindirme kısmi sonuçları göstermeli ve sonra göndermelidir.
* Basılı tutarken menü çubuğu kulakları büyümüş kalmalıdır (`triggerVoiceEars(ttl:nil)` kullanır); bırakmadan sonra küçülürler.

## İlgili

* [Sesle uyandırma](/tr/nodes/voicewake)
* [Ses bindirmesi](/tr/platforms/mac/voice-overlay)
* [macOS uygulaması](/tr/platforms/macos)