Durum Düğümleri Uygulama Rehberi

01 · Hızlı Tanıtım

Durum araçlarında değeri tutan bir nesne ve onu okuyan veya değiştiren işlemler vardır:

Durum Düğümü

Tuvalde bulunur.
Değeri tutar (AÇIK/KAPALI, sayı, zaman damgaları veya kullanıcılar).
Geçit, Sayaç ve Hız Sınırlayıcı normal etkinlik yolunda çalışabilir.
Kullanıcı Belleği diğer düğümlerin başvurduğu ortak merkezdir.

Durum Eylemi

Sonraki aşamaya yerleştirilir.
Saklanan değeri okur veya değiştirir (AÇIK yap, +1 ekle, hatırla, çekiliş yap, sıfırla vb.).
Akışın herhangi bir yerinde olabilir — eşleşen düğüm adını seçmeniz yeterlidir.

Unutmayın: Önce Durum düğümünü ekleyip benzersiz ad verin; sonra ilgili her işlemde seçin. Temel düğüm olmadan durum eylemlerinin güncelleyeceği bir şey yoktur.

02 · Aç/Kapat Anahtarı (Geçit)

Anahtar mantıksal bir koruyucudur. AÇIK olduğunda mesajlar geçer; KAPALI olduğunda akış bu düğümde durur.

En uygun kullanım

Sohbet komutları için bekleme süreleri.
Elle anahtarlar (katmanları açma/kapatma).
Bakım aralıkları (BRB sahnelerinde özellikleri duraklatma).

Temel Eylemler

Set Gate State— AÇIK veya KAPALI yapın.
Reset State Node— varsayılana dönün (genellikle AÇIK).

Örnek: 15 sn Bekleme Süresi

!hello ──▶ Switch (ON?) ─▶ Send Reply ─▶ Set Gate: OFF ─▶ Delay 15s ─▶ Set Gate: ON

Oluşturma Adımları

Anahtar düğümünü ekleyin, adını “helloCooldown”, varsayılanını AÇIK yapın.
Tetikleyici → anahtar → eylemler şeklinde bağlayın.
Eyleminizden sonra şunu ekleyin: Geçit Durumunu Ayarla (KAPALI), “helloCooldown” seçili olarak.
Şunu ekleyin: Gecikme düğümü (15 saniye).
Bir tane daha ekleyin: Geçit Durumunu Ayarla (AÇIK), “helloCooldown” için.

03 · Sayaç

Sayaçlar mesajlar arasında sayıları takip eder. Mesaj geçtiğinde otomatik artar; eylemlerle değerleri elle de ayarlayabilirsiniz.

Otomatik artırma: Sayaç düğümünden her veri geçtiğinde 1 ekler (“Yalnızca geçit doğruyken say” seçeneğiyle duraklatmadığınız sürece).

Kullanım Alanları

Her N'inci sohbet katılımcısı ödül tetikler.
Topluluk hedefine ilerlemeyi takip edin.
Komutlarla kullanılan puanları saklayın.

Eylemler

Increment Counter— özel miktarlar ekleyin veya çıkarın.
Set Counter Value— belirli sayıya geçin.
Reset State Node— varsayılan başlangıç değerine dönün.

Örnek: Her 5 Mesajda Bir Kutlayın

Any Message ─▶ Counter (name: hype5) ─▶ Condition (value % 5 === 0?) ─▶ Play Celebration

Koşul düğümünde şunu karşılaştırın: state.hype5.value veya Sayaç düğümü özelliklerindeki yerleşik “Değer Hedefle eşleştiğinde tetikle” seçeneğini kullanın.

04 · Hız Sınırlayıcı (Kısıtlama)

Kısıtlayıcı zaman damgalarını hatırlar ve belirlediğiniz hıza uyulana kadar yeni etkinlikleri reddeder.

Şunlar Gerektiğinde Kullanışlıdır

“Dakikada yalnızca beş çekiliş katılımı.”
“10 saniyede bir API çağrısı.”
“Katman zaten meşgulse uyarıları at.”

Yapılandırma

İzin verilen en fazla etkinlik sayısını ayarlayın.
Zaman aralığını seçin (saniye).
Sınırı aşanları kuyruğa mı alacağınıza, atacağınıza mı karar verin.

Dikkat: Akışı düzenlediğinizde kısıtlayıcılar otomatik sıfırlanmaz. Şunu kullanın: Reset State Node test sırasında temiz başlangıç gerekiyorsa.

05 · Kullanıcı Belleği

Kullanıcı Belleği, benzersiz kişilerin adlandırılmış tek listesini tutar. Katıldıklarında kullanıcıları hatırlayın, sonraki mesajlarda listeyi kontrol edin, bir kişiyi kaldırın, rastgele kazanan seçin veya yalnızca o listeyi temizleyin.

En uygun kullanım

Hediyeye veya rozete dayalı uygunluk.
Beğenen, katılan veya etkileşen izleyicileri hatırlama.
Kişi başına tek katılımlı ödül çekilişleri.
Farklı kampanyalar için ayrı listeler.

İşlemler

Remember User ve Forget User.
User Is Remembered.
Pick Random User.
Clear All Users veya Reset State Node.

Participation Trigger ──▶ Remember User ······▶ User Memory: Entrants Draw Command ───────────▶ Pick Random User ···▶ User Memory: Entrants Reset Command ──────────▶ Clear All Users ·····▶ User Memory: Entrants

Düz turkuaz bağlantılar etkinlik taşır. Kesikli mor bağlantılar işlemin hangi ortak belleği kullandığını gösterir. Her Kullanıcı Belleği'nin kendi sayısı, kalıcılık modu ve sıfırlama politikası vardır; bir listeyi temizlemek diğerini etkilemez.

Özel rehbere bakın: Kullanıcı Belleği kılavuzu incelenmiş ekran görüntüleri, indirilebilir çekiliş akışı, TikTok uygunluğu, katılım örnekleri ve sıfırlama ayrıntıları için.

06 · Çözüm Paketleri

Bir senaryo seçip adımları izleyin.

Komut Bekleme Süresi

“commandCooldown” adlı anahtar düğümü.
Tetikleyici → anahtar → yanıt.
Geçidi KAPALI Yap → Gecikme → Geçidi AÇIK Yap.
İsterseniz yanlış çıkışına “Bekleme süresi etkin” sohbet mesajı ekleyin.

Sınırlı Ücretsiz Hediyeler

Sayaç varsayılanı 0, hedefi 3.
Her ödül kullanımından sonra artırın.
Değer ≥ 3 olduğunda “Üzgünüz, hepsi bitti” dalına geçin.
Yayın sonunda Sıfırla eylemini kullanın.

İzleyici Anahtarı

“overlayToggle” adlı anahtar.
!overlay on komutu → Geçidi AÇIK Yap.
!overlay off komutu → Geçidi KAPALI Yap.
Tüm katman tetikleyicileri anahtardan geçer.

Örnek Akış Şemaları

Trigger ─▶ Switch (overlayToggle) ─▶ If ON → Show Overlay └─false─▶ Notify moderator “Overlay disabled”

Redeem Reward ─▶ Counter ticketsSold ├─value < 50 ─▶ Approve Redemption └─value ≥ 50 ─▶ Deny + Refund points

07 · Sorun Giderme ve SSS

Belirti	Olası Neden	Çözüm
Geçit Durumunu Ayarla eylemi kaydedilmiyor.	Eşleşen anahtar düğümü yok (veya adlar farklı).	Önce anahtar düğümünü ekleyin ve açılır listenin onu seçtiğini doğrulayın.
Sayaç hiç artmıyor.	Akış sayaç düğümünü atlıyor veya geçit yanlış.	Tetikleyici bağlantısının sayaçtan geçtiğinden ve geçit çıkışının doğru olduğundan emin olun.
Kısıtlayıcı her şeyi sürekli engelliyor.	Zaman aralığı fazla kısıtlayıcı veya testten kalan durum var.	Sınırı gevşetin ve yeniden test etmeden önce Durum Düğümünü Sıfırla eylemi ekleyin.
Kullanıcı Belleği işleminin kesikli bağlantısı yok.	Hedef bellek seçilmemiş.	İşlemin özelliklerinde adlandırılmış belleği seçin veya mor yan bağlantısını belleğin üzerine sürükleyin.
Rehber düğmeleri açılmıyor.	web_accessible kaynakları güncellenmeden uzantı içinde çalıştırılıyor.	Şunu doğrulayın: `actions/state-nodes-guide.html` manifest üzerinden sunulduğunu doğrulayıp uzantıyı yeniden yükleyin.

Test Kontrol Listesi

Komutları canlandırmak için Etkinlik Akışı'nın “Test Etkinliği Gönder” aracını kullanın.
Doğrularken bekleme sürelerini geçici olarak kısaltın (2 saniye) veya sayaç hedeflerini düşürün.
Eski verileri okumamak için testler arasında durum düğümlerini sıfırlayın.
Yolu görsel olarak izleyebilmek için dalları etiketleyin (ör. “yanlış → bekleme süresi etkin”).

08 · Sonraki Adımlar

Durum düğümlerini Etkinlik Akışı'nın diğer araçlarıyla birleştirin:

Anahtarı kimin değiştirebileceğine karar vermek için öncesinde mantık kapıları (AND/OR/NOT) kullanın.
Duruma bağlı üst verileri şu alanda saklayın: meta katmanların dalın neden tetiklendiğini bilmesi için.
Ekibinizin daha sonra yeniden içe aktarabilmesi için çalışan örüntüleri şablon olarak dışa aktarın.

Denemeye devam edin! Yeni Etkinlik Akışı Kılavuzu bu uygulama rehberini tamamlar; böylece hem mantık hem durum katmanında uzmanlaşabilirsiniz.