أظهر صورة على الشاشة: رسمة الهدية/الإيموجي، أو ملف مرفوع، أو أي رابط. تُزال تلقائيًا بعد ثوانٍ.

// Show an image, then fade it out
TE.on('gift', function (ev) {
  var img = document.createElement('img');
  img.src = ev.gift.image;                 // ← any image URL works
  img.style.cssText = 'position:absolute;left:50%;top:50%;transform:translate(-50%,-50%);max-width:60%';
  document.body.appendChild(img);
  setTimeout(function () { img.remove(); }, 4000);   // ← how long it stays
});

شغّل صوتًا عند حدث. أتِح إعداد sound ليختار صانع البث ملفه الخاص، دون تعديل الكود.

// Play a sound the streamer chose in settings
var s = TE.defineSettings([{ key: 'sfx', label: 'Alert sound', type: 'sound', default: '' }]);
TE.on('settings', function (ns) { s = ns; });
TE.on('gift', function (ev) {
  if (s.sfx) { var a = new Audio(s.sfx); a.volume = 0.8; a.play(); }
});

اكتب نصًا ديناميكيًا وأعد تشغيل حركة CSS بتبديل class.

// Announce the event with a CSS pop animation
var box = document.getElementById('box');   // your element in the HTML tab
TE.on('follow', function (ev) {
  box.textContent = ev.user.name + ' followed!';
  box.classList.remove('pop'); void box.offsetWidth; box.classList.add('pop');
});

اربط رقمًا على الشاشة بمقياس مباشر، كالمشاهدين والإعجابات والعملات والمتابعين، يتحدّث تلقائيًا.

// Keep a number in sync with the live stream
TE.on('metrics', function (m) {
  document.getElementById('count').textContent = m.viewers.toLocaleString();
});

انطق حدثًا بميزة تحويل النص إلى كلام في المتصفح. مثالي للإشادة بالهدايا أو المتابعات.

// Text-to-speech shout-out
TE.on('gift', function (ev) {
  var u = new SpeechSynthesisUtterance(ev.user.name + ' sent ' + ev.gift.name);
  speechSynthesis.speak(u);
});

كل ويدجت تعرض نفسها في المعرض والمنشئ: عينات تشبه الأحداث الحقيقية، برسومات هدايا وأسماء وصور شخصية حقيقية. أثناء البث تكون TE.demo بقيمة false ولا تظهر إلا الأحداث الحقيقية.

// Preview samples through the real code path. Never on a live overlay.
if (TE.demo) {
  var GIFTS = [
    { name: 'Rose', coins: 1, image: 'https://p16-webcast.tiktokcdn.com/img/maliva/webcast-va/eba3a9bb85c33e017f3648eaf88d7189~tplv-obj.png' },
    { name: 'Perfume', coins: 20, image: 'https://p16-webcast.tiktokcdn.com/img/maliva/webcast-va/20b8f61246c7b6032777bb81bf4ee055~tplv-obj.png' }
  ];
  var NAMES = ['lunaa', 'nightowl_gaming_official'], n = 0;
  function sample() {
    n++;
    onGift({ user: { name: NAMES[n % 2], avatar: window.__TE_AVATAR }, gift: GIFTS[n % 2] });
  }
  sample();
  setInterval(sample, 6000);
}

حفظ متزامن بسيط للحالة المرئية. استخدم بيئة التشغيل المعاملاتية للمشاركين والمشتريات والنقاط المشتركة.

// Persistent state: survives OBS reloads
var total = TE.store.get('total', 0);          // read (with default)
TE.on('gift', function (ev) {
  total += ev.gift.coins;
  TE.store.set('total', total);                 // write (auto-saved)
  render();
});

أوامر دردشة بمطابقة تامة مع مجموعات ذرّية تتيح مشاركات وتصويتات ودورات عجلة آمنة.

// One server-authoritative entry per viewer.
// A function keyword reads s.command on every message, so the
// streamer can change the command in settings without a reload.
TE.onCommand(function () { return s.command || '!join'; }, function (c) {
  TE.collection.join('entrants', c.user.id, c.user).then(function (result) {
    if (result.joined) renderCount(result.count);
  });
});

اطلب تنبيهات الأوفرلي أو الأصوات أو TTS أو العدادات أو وقت السباثون أو تبديل مشاهد OBS مباشرة من الويدجت.

// One call, one stream action
TE.act({ id: 'tts', message: 'New high score!' });
TE.act({ id: 'points', user: ev.user, amount: 50 });

تحقّق من نقاط الولاء أو أنفقها أو امنحها ضمن معاملة، واستلم الرصيد الناتج.

// Only spin after the points were really debited
TE.onCommand(function () { return s.command || '!spin'; }, function (ev) {
  TE.points.trySpend(ev.user, 50, 'Wheel spin').then(function (result) {
    if (result.ok) spin();
    else showMissing(result.missing);
  });
});

حالة ذرّية، ومجموعات، وسحب عشوائي آمن، وفترات انتظار، ومؤقتات دائمة، آمنة حتى مع تكرار مصادر المتصفح.

// Fair draw from a server-owned entrant collection
TE.random.draw('entrants', { count: 1 }).then(function (result) {
  if (result.ok) reveal(result.winners[0].value);
});

أتِح النصوص والألوان والأرقام ومفاتيح التبديل، ويعدّلها صانع البث مباشرة في محرر الأوفرلي، دون كود.

// No-code controls for whoever uses the widget
var s = TE.defineSettings([
  { key: 'title',  label: 'Title', type: 'text',  default: 'Goal' },
  { key: 'accent', label: 'Color', type: 'color', default: '#FF2E4D' },
]);
document.body.style.setProperty('--accent', s.accent);
TE.on('settings', function (ns) { s = ns; /* re-render with new values */ });