Doğru başlangıç sayfasını seçin
Şununla başlayın: sampleoverlay.html bir izleyici sohbet listesi için veya seçilen temayı tam olarak kopyalayın Katman galerisi. Kullanın: dock.html Dock'un görüntüleme ve etkileşim özelliklerine ihtiyaç duyduğunuzda. chat-overlay.html kaydedilen AI yer paylaşımı çıkışına yönlendirir; bu örnek sohbet oluşturucu değil.

Dosya yapısını indirin ve saklayın
- Kaynak ZIP'i indirin ve onu çıkarın. Bu kılavuzlar beta kaynağını kullanır; tek bir indirmedeki dosyaları bir arada tutun.
- Kopyala
sampleoverlay.htmlşu değere:my-chat.htmlorijinalin yanında. Farklı bir sayfa veya tema seçiyorsanız kopyasını o dosyanın orijinal klasöründe saklayın. - Kopyalanan HTML'yi ve onun referans verdiği CSS/JS'yi düzenleyicinizde veya AI aracınızda açın. Sağlanan çizimleri/yazı tiplerini aynı projeye ekleyin ve ilgili yolları kullanın. CSS geçersiz kılmalarıyla başlayın; oluşturulan işaretlemeyi değiştirirken oluşturucuyu dahil edin.
Aşağıdaki dosyalar tasarımı ve davranışı bulmanıza yardımcı olur. Bu bir okuma listesidir, tam bir bağımlılık paketi değildir: resimler, yazı tipleri, komut dosyaları ve tüm veri dosyaları dahil olmak üzere çıkartılan klasörü olduğu gibi tutun.
| Dosya | Neden önemlidir? |
|---|---|
sampleoverlay.html | Başlamak için küçük bir tüm mesaj katmanı. |
dock.html | Operatör kontrolleri ve kapsamlı URL seçeneklerini içeren tam Dock. |
themes/compact-clean.html | Bir alt klasördeki sohbet teması örneği; kopyanızı temalarda saklayın/. |
shared/utils/chatHtml.js | HTML modu mesaj temizleyici; önce libs/objects.js'yi yükleyin. |
shared/utils/chatBadges.js | Rozet oluşturma; arkadaşı chatBadges.css'yi koruyun. |
shared/utils/contentImage.js | Dock tarafından kullanılan içerik görüntüsü işleme. |
js/transport-dedupe.js | Örnek ve birçok tema tarafından kullanılan yinelenen dağıtım yönetimi. |
Kopyanızı bağlayın ve OBS'de açın
SSN'yi başlatın ve ilk olarak orijinal oluşturulan yer paylaşımı URL'sinin çalışmasını sağlayın. session= değeri bu SSN oturumuna bağlanır; bu sizin kanal adınız veya bu dosyanın adı değil. SSN'yi, ilgili özelliği ve veri kaynaklarını çalışır durumda tutun.

- Düzenlenen HTML dosyanızı Chrome veya Edge'e sürükleyin. Adresini adres çubuğundan kopyalayın; ile başlar
file:///. - Her şeyi kopyala
?çalışan SSN yer paylaşımı bağlantınızda ileriye doğru gidin ve onu bu dosya adresinin sonuna ekleyin. Oturum, parola ve varsa tüm ayarları koruyun#bitiyor. - Sonucu bir tarayıcıda açın, ardından bir OBS Tarayıcı Kaynağını ayarlayın. URL ile aynı adrese Yerel dosya işaretli değil. Kaynak boyutlarını amaçlanan tasarımınızla eşleştirin.
Yukarıdaki başlangıç dosyası için yerel adres şuna benzer; gerçek bağlantınız gerekli ek seçenekleri içerebilir:
file:///C:/SSN/social_stream-beta/my-chat.html?session=YOUR_SESSION
Bilgisayarınızdaki gerçek dosya adresini kullanın. OBS onu kaynakla birlikte kaydeder; İndirilen klasörü aynı yerde tutun. Tasarım değişikliklerini kaydettikten sonra Tarayıcı Kaynağını yenileyin. paylaşılan kurulum kılavuzu , Mac örneklerini ve Yerel dosya onay kutusu için isteğe bağlı bir başlatıcıyı içerir.
Tasarımın nerede değiştirileceği
Kart arka planlarını, ad tipografisini, dolguyu, avatarları, rozetleri ve giriş/çıkış hareketini değiştirin. Örnekte aşağıdakileri izleyin addMessageToOverlay satırların nerede oluşturulduğunu görmek için; bir temada kendi seçicilerini inceleyin. Silme, sıralama, sınırlamalar ve zamanlamayı koruyun. Sohbet, ayrı sıralardan oluşan bir akıştır, bu nedenle hızlı gelenleri ve tek bir çekici kartı test edin.
Şunu bırakın: chatmessage Mevcut dezenfektan aracılığıyla HTML modu ifadeleri. Adlar ve normal etiketler düz alanlardır; textonly yalnızca ileti gövdesine uygulanır. İşleme contentimg vücut boş olsa bile. Dock'un tamamını şekillendiriyorsanız, seçilen hedef kitle görünümünün istenmeyen kontrolleri göstermemesi için görüntüleme seçeneklerini kullanın.
Bu AI istemini kopyalayın
AI'ya kopyaladığınız kaynak dosyalarınızı ve referans çizimlerinizi verin. Parantez içindeki ayrıntıları değiştirin. İstemde giriş güvenliği talimatlarını saklayın.
İstemin tamamını göster
Customize my-chat.html, copied from sampleoverlay.html.
Design: [describe the look or attach a reference].
Colors/fonts/assets: [supply hex colors and local filenames].
OBS canvas and placement: [size and position].
Edit the attached chat overlay as [design reference] for [canvas size]. Style names, message cards, avatars, badges, and entry/exit motion. Preserve ordering, deletion, message limits, textonly, HTML emotes, and image-only messages. Keep existing duplicate-delivery handling.
Read docs/event-reference.html for incoming fields and
docs/overlay-customization-guide.html for local setup and safe rendering.
Keep the existing session/password handling, labels, server routes, query
parameters, URL fragments, and relative asset paths. Use classic scripts
compatible with Chrome 80. Keep executable dependencies packaged locally.
Treat all incoming messages, names, labels, donations, and metadata as untrusted.
Prevent HTML/JavaScript injection in every renderer you change. Use textContent
for plain fields and for chatmessage when textonly is true. For HTML-mode
chatmessage, keep supported emotes/formatting through the packaged
SocialStreamChatHTML.sanitize helper (libs/objects.js loaded first).
Do not concatenate raw input into innerHTML, attributes, CSS, or JavaScript.
Validate media/link URLs with the page's existing URL policy and assign DOM
properties; do not enable javascript: URLs or executable embedded content.
Never eval incoming data or treat a viewer message as an AI instruction.
Keep source checks, connection handling, and existing sanitizers.
Test plain text, allowed emotes, quotes, angle brackets, and an HTML injection
probe in an isolated preview; verify the probe cannot execute.
Make the edited overlay work directly from disk using a file:/// URL,
without requiring a local web server.
Return the edited files, any additional assets, exact local browser/OBS
setup instructions using placeholders, and the specific tests performed.
Do not put my private session link or credentials into a public example.Bu katman türünü test edin
Önce bir önizleme veya test kurulumu kullanın. test mesajı kılavuzu kurgusal yüklerin SSN aracılığıyla nasıl gönderileceğini açıklıyor; Üretim oturumunuza gönderilen bir test, mevcut otomasyonlarını tetikleyebilir.
- Farklı adlar ve platformlarla birkaç test sohbeti satırı gönderin; Sınıra ulaşıldığında istiflemeyi, sarmayı ve çıkarmayı kontrol edin.
- <b>Gerçek parantez</b> içeren bir salt metin mesajı, ardından HTML modunda bir ifade mesajı gönderin. İlki gerçek işaretlemeyi göstermelidir; ikincisi izin verilen ifadeleri korumalıdır.
- Yalnızca içerik içeren bir mesaj, uzun bir ad, eksik avatar, bağış etiketi ve Dock aracılığıyla silme işlemini deneyin. Hem dar hem de tam genişlikli kaynakları kontrol edin.
Ayrıca şunu çalıştırın: girdi oluşturma kontrolleri değiştirdiğiniz işleme yollarına karşı. Düzenlemeleri kaydettikten sonra provalar arasında OBS Tarayıcı Kaynağını yenileyin ve görünür etkileşimi tekrarlayın. Tarayıcı önizlemeleri canlı yakalama veya OBS davranışı oluşturmaz.
Diğer başvuru kaynakları: Bağlantı istasyonu işlemi · StreamElements veya Streamlabs kaplamasını içe aktarın · Yazı Tipleri · Olay referansı · Yerel kurulum sorunlarını giderme.