TokElementsDOCS
WIDGET SDK / V1

תיעוד SDK לווידג׳טים של TikTok LIVE

בנה ווידג׳טים מותאמים ל-TikTok LIVE עם ה-SDK של TokElements ב-JavaScript. אירועי לייב, פעולות, הגדרות, כללי sandbox ודוגמאות אינטראקטיביות.

01

צעדים ראשונים

1
כתוב מבנה ועיצוב

הלשוניות HTML ו-CSS מציירות את הווידג׳ט. התיבה שקופה ומרחפת מעל הווידאו, אז אף פעם אל תצייר רקע אטום על כל השטח.

2
הגב לאירועים

בלשונית JS, הירשם עם TE.on('gift', fn). window.TE כבר טעון: בלי imports, בלי הגדרות.

3
בדוק והוסף

השתמש ב-Simulate או בכפתורי Fire לתצוגה מקדימה אופליין, ואז Add to overlay. או תן ל-Claude לבנות אותו דרך MCP.

הווידג׳ט הראשון שלך: תודה על מתנה· ערוך את ה-JS, התצוגה מגיבה בזמן אמת
var box = document.getElementById('box');
TE.on('gift', function (ev) {
  box.textContent = ev.user.name + ' sent ' + ev.gift.name + '!';
  box.classList.remove('pop'); void box.offsetWidth; box.classList.add('pop');
});
תצוגה חיה
02

חיבור Claude (MCP)

בנה וערוך את הווידג׳טים האלה ישירות מ-Claude Desktop או Claude Code. צור טוקן, הוסף את המחבר, ו-Claude יוכל להפעיל את הכלים האלה בחשבון שלך:

get_docsמדריך הכתיבה המלא + כל טריגר ופעולה (Claude קורא את זה קודם).
list_widgetsרשימת הווידג׳טים השמורים שלך עם ה-id שלהם.
get_widgetשליפת ה-html / css / js של ווידג׳ט אחד.
create_widgetיצירת ווידג׳ט HTML חדש משם + html/css/js.
update_widgetעריכת ווידג׳ט קיים.
delete_widgetמחיקת ווידג׳ט לפי id.
list_templatesרשימת התבניות המובנות להעתקה.
get_templateקריאת ה-html/css/js של תבנית.
create_from_templateהעתקת תבנית לווידג׳ט חדש.
list_community_templatesעיון בווידג׳טים שפרסמה הקהילה.
install_community_templateהתקנת עותק פרטי וניתן לעריכה של תבנית מהקהילה.
טוען…
03

ה-SDK של TE

כל מה שווידג׳ט עושה עובר דרך האובייקט הגלובלי window.TE.

TE.on(type, fn)

הרשמה לאירוע לייב. `type` הוא כל טריגר מהרשימה למטה; `fn(ev)` רץ בכל פעם שהוא קורה.

TE.on('*', fn)

תפיסת כל אירוע. `fn(ev, type)` מקבל את המידע ואת שם האירוע.

TE.off(type, fn)

הסרת handler שנרשם קודם.

TE.onGift(name, fn)

מופעל רק למתנות שהשם שלהן תואם (חלק מהשם, בלי תלות באותיות גדולות). השמט את `name` כדי לתפוס כל מתנה.

TE.onSticker(idOrUrl, fn)

מופעל רק לאימוג׳י / סטיקר מנויים אחד מסוים, לפי ה-id שלו ב-TikTok, כתובת התמונה או המקור.

TE.rules.allowUser / allowGift

מסננים לשימוש חוזר לפי תפקידים, רשימות היתר/חסימה, שם מתנה ושווי מינימלי במטבעות.

TE.metrics

אובייקט תמונת המצב העדכנית של השידור (viewers, likes, coins, followers, topGifters…). נשלח גם דרך TE.on('metrics', fn).

TE.demo

true כשהווידג׳ט מוצג לראווה (גלריה, כרטיסי תצוגה, מתג Demo ב-builder). false באוברליי חי ובזמן בדיקה ב-builder או בעורך האוברליי, שם מופיע רק מה שאתה מפעיל או מה שמגיע מהלייב. כל ווידג׳ט מציג את עצמו שם: שים דוגמאות שנראות כמו אירועים אמיתיים (תמונות מתנה אמיתיות, שמות, אווטארים) בבלוק if (TE.demo), דרך מסלול הקוד האמיתי של הווידג׳ט. ווידג׳ט עם בלוק כזה לא מקבל אירועי תצוגה מהמערכת, כך ששום דבר לא מופעל פעמיים.

TE.defineSettings([...])

הגדרת פקדים שהסטרימר יכול לכוונן; מחזיר את הערכים הנוכחיים (ברירות מחדל ממוזגות עם הבחירות של הסטרימר).

TE.settings

אובייקט ערכי ההגדרות הנוכחי (באותו מבנה ש-defineSettings החזיר).

TE.on('settings', fn)

רץ כשהסטרימר משנה הגדרה בזמן אמת: רנדר מחדש עם הערכים החדשים.

TE.state.get/set/increment

ערכים אטומיים מבוססי Promise לסכומים ולמצב משחק משותף.

TE.collection.*

משתתפים בהצטרפות חד-פעמית וטבלאות ניקוד שמנוהלים בשרת: join, increment, list, count, remove ו-clear.

TE.queue.*

תורי FIFO מוגבלים שמנוהלים בשרת למדיה, בקשות ופעולות שהצופים מפעילים.

TE.shared.*

צירוף כמה ווידג׳טים למרחב מצב ערוץ משותף בשם אחד; ווידג׳טים אחרים נשארים מבודדים.

TE.random.draw(name, opts)

הגרלה מאובטחת של זוכה אחד או יותר מאוסף ותיעוד התוצאה.

TE.cooldown.claim(scope, user, ms)

תפיסה אטומית של cooldown גלובלי או לכל משתמש; מחזיר claimed ו-retryAfterMs.

TE.timer.*

הפעלה, השהיה, איפוס וקריאה של טיימר שעון קיר שנשמר ושורד טעינות מחדש.

TE.points.trySpend(user, amount, reason)

בדיקה וחיוב נקודות בטרנזקציה אחת; תמיד בדוק result.ok לפני שמריצים אינטראקציה בתשלום.

04

טריגרים

אירועי לייב שאפשר להאזין להם. כל user מכיל { id, name, username, avatar, roles }.

TE.on('gift')

צופה שלח מתנה. coins = הסכום לכל הקומבו; streakEnd מסמן שהקומבו הסתיים.

{ user, gift: { name, image|null, coins, repeat, combo, streakEnd } }
TE.on('follow')

צופה התחיל לעקוב אחרי החשבון.

{ user }
TE.on('subscribe')

צופה נרשם כמנוי. months = כמה חודשים ברצף.

{ user, months }
TE.on('share')

צופה שיתף את הלייב.

{ user }
TE.on('chat')

הודעת צ׳אט. emotes = כתובות התמונות של אימוג׳י המנויים בהודעה.

{ user, comment, emotes:[url,…] }
TE.on('like')

צופה שלח לייקים. count = הסדרה הנוכחית; total = הסכום המצטבר.

{ user, count, total }
TE.on('join')

צופה נכנס לחדר. isTop = נכנס אחד השולחים המובילים.

{ user, isTop }
TE.on('sticker')

אימוג׳י מנויים או סטיקר על המסך שנשלח בלייב. url = תמונת האימוג׳י; id = ה-id שלו ב-TikTok.

{ user|null, id|null, url, source }
TE.on('metrics')

תמונת המצב העדכנית של השידור. TE.metrics מחזיק אותה; האירוע מופעל בכל עדכון. hostNick ו-hostAvatar הם השם ותמונת הפרופיל של הסטרימר עצמו.

{ live, viewers, likes, followers, coins, hostNick, hostAvatar, topGifters:[…], … }
TE.on('milestone')

נחצתה אבן דרך עגולה (לייקים, מטבעות, עוקבים, מנויים).

{ metric, value, label }
TE.on('poll')

הסקר המובנה של TikTok בלייב: הצבעות אמיתיות, מההתחלה ועד הסוף.

{ state:'start'|'update'|'end', title, options:[{text,votes}], endsAt }
TE.on('battle')

עדכוני קרבות LinkMic: כרטיסי קרב, כרטיסי מעריצים, גודל הצבאות.

{ card|null, tickets|null, armies|null, battleId|null }
TE.on('rank')

המיקום בדירוג השעתי ורגעי עלייה בדירוג.

{ rank|null, from|null, to|null, countdown|null }
TE.on('envelope')

מעטפה אדומה / תיבת אוצר הופלה בלייב.

{ }
TE.on('pinned')

המארח הצמיד תגובה.

{ text }
TE.on('deleted')

מודרטור הסיר הודעת צ׳אט (ה-id תואם לאירוע ה-chat הקודם).

{ id }
TE.on('streamState')

השידור עלה לאוויר או ירד.

{ live }
TE.on('apiEvent')

אירוע מותאם שנשלח דרך Event API. האזן ל-apiEvent או ישירות לשם המותאם שלו.

{ name, data }
TE.on('nowPlaying')

השיר הנוכחי של הסטרימר ב-Spotify וגם התור הבא. מופעל בהתחברות ובכל שינוי בשיר, במצב הניגון, בהתקדמות או בתור. playback הוא null כששום דבר לא מתנגן; queue הוא השירים הבאים.

{ connected, playback: { isPlaying, progressMs, durationMs, title, artists:[…], album, artwork|null } | null, queue:[{ title, artist, artwork|null, durationMs }] }
רק מתנה או אימוג׳י מסוים אחד
TE.onGift('Rose', function (ev) { /* … */ });
TE.onSticker('<sticker id>', function (ev) { /* … */ });

האימוג׳י של הערוץ שלך נמצאים ב-widget builder: פתח את Simulate events, בחר Sticker ובחר אחד. אירוע הבדיקה נושא את ה-id ואת כתובת התמונה האמיתיים, כך ש-handler שמבוסס על אחד מהם נבדק עם הדבר האמיתי.

05

פעולות

מה הווידג׳ט שלך יכול לעשות בתגובה: APIs רגילים של הדפדפן, מוכנים להדבקה.

הצגת תמונה

הקפצת תמונה על המסך: התמונה של המתנה/האימוג׳י, קובץ שהעלית או כל URL. נעלמת לבד אחרי כמה שניות.

// 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();
});
הקראה בקול (TTS)

הקראת אירוע עם ה-text-to-speech של הדפדפן. מעולה לתודות על מתנות או עוקבים.

// 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)

כל ווידג׳ט מציג את עצמו בגלריה וב-builder: דוגמאות שנראות כמו אירועים אמיתיים, עם תמונות מתנה, שמות ואווטארים אמיתיים. בלייב, 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);
}
לזכור דברים (TE.store)

שמירה סינכרונית פשוטה למצב ויזואלי. למשתתפים, רכישות וניקוד משותף השתמש ב-runtime הטרנזקציוני.

// 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);
  });
});
הפעלת פעולות שידור (TE.act)

בקשת התראות אוברליי, צלילים, TTS, מונים, זמן subathon או החלפת סצנות ב-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);
  });
});
בניית משחקים הוגנים

מצב אטומי, אוספים, הגרלות מאובטחות, cooldowns וטיימרים קבועים, בטוחים גם עם מקורות דפדפן כפולים.

// 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 */ });
06

הגדרות לסטרימר

הגדר פקדים עם TE.defineSettings([...]) וכל מי שמשתמש בווידג׳ט מכוונן אותם בזמן אמת בעורך האוברליי, בלי קוד. כל שדה:

ווידג׳ט ממוקם עם שדה 'button' אחד או יותר חושף את הפעולות האלה בהגדרות שלו בתוך Overlay Editor. ה-Widget Builder מציג את אותם כפתורים לבדיקה בטוחה בזמן הכתיבה.

סוגמציגערך
'text'שדה טקסט בשורה אחתstring
'number'שדה מספרnumber
'color'בורר צבעמחרוזת hex, למשל "#FF2E4D"
'select'תפריט נפתח (צריך options: [...])אחת האפשרויות
'toggle'מתג הפעלה/כיבויboolean
'range'סליידר (min / max / step)number
'button'כפתור פעולה הצהרתיincrement, set או toggle: JSON מאומת, אף פעם לא קוד של הדשבורד
'sound'בורר מתוך הצלילים שהסטרימר העלה + Uploadה-URL של הקובץ שנבחר ("" = כלום)
'image'בורר מתוך התמונות שהסטרימר העלה + Uploadה-URL של הקובץ שנבחר ("" = כלום)
'model'בורר מתוך מודלי ה-3D שהסטרימר העלה (.glb) + Uploadה-URL של קובץ ה-.glb שנבחר ("" = כלום), עבור TE.lib('three')
var s = TE.defineSettings([
  { key: 'title',  label: 'Title', type: 'text',   default: 'Follower goal' },
  { key: 'target', label: 'Goal',  type: 'number', default: 100 },
  { key: 'accent', label: 'Color', type: 'color',  default: '#FF2E4D' },
  { key: 'reset',  label: 'Reset', type: 'button', default: 0,
    action: { type: 'increment', step: 1 }, confirm: true, tone: 'danger' },
]);
// re-render when the streamer changes something live
var lastReset = s.reset;
TE.on('settings', function (ns) {
  s = ns;
  if (ns.reset !== lastReset) { lastReset = ns.reset; resetCounter(); }
  render();
});

הגדרות הפקדים הן נתונים מאומתים. action של כפתור מקבל רק increment, set או toggle. HTML, קוד callback וכתובות URL שרירותיות נדחים או מתעלמים מהם ברנדרר של הדשבורד.

07

מנוע 3D

תלת-ממד אמיתי בכל ווידג׳ט: await TE.lib('three') טוען את TE3D, מנוע three.js שמגיע עם TokElements (בלי CDN, עובד אופליין). הוא הופך כל שם של צופה לאותיות תלת-ממדיות בולטות, כולל ערבית,ומוסיף חומרים, סגנונות קומיקס, מודלי 3D שהעלית ואפקטים קולנועיים. הקנבס נשאר שקוף ב-OBS.

T.stage({ bloom, look })

קנבס 3D שקוף אחד בגודל מלא לכל ווידג׳ט, עם השתקפויות סטודיו, זוהר (bloom) ולולאת רינדור. look בוחר את סגנון העיבוד.

T.text3d(text, opts)

טקסט בולט אמיתי (עומק + שיפוע) מכל שם. ערבית מעוצבת מימין לשמאל, אותיות מעוטרות מנורמלות, אימוג׳י מדולגים: העבר את ה-@username כגיבוי. אפשרויות: size, depth, bevel, maxWidth, color, style ('cinematic', 'bold', 'tech', 'comic'), material, outline, perLetter.

T.letters(text, { effect })

כניסות אות אחר אות לטקסט שנוצר עם perLetter: true: 'drop', 'pop', 'spin', 'rise' או 'scatter'.

T.wave(stage, text)

שומר על טקסט perLetter בתנועה עם גל שעובר בין האותיות.

T.animate(obj, to, opts)

אנימציה של מיקום, סיבוב, גודל ושקיפות עם easing ('outBack', 'outBounce', 'outElastic', …). מחזיר Promise.

stage.look() · shake() · glitch()

מחליף את כל הבמה בין סגנונות, מרעיד את המצלמה בפגיעה, או מוסיף גליץ׳ לתמונה.

T.model(url, { size })

טוען מודל .glb שהועלה, בגודל ובמרכז; stage.add(model) מריץ את האנימציות שלו. בקש אותו עם הגדרת 'model'.

stage.onFrame(fn)

קורא ל-fn בכל פריים עם צעד הזמן והשניות שעברו. מחזיר off().

T.stage({ parent }) · stage.frame(w, h)

parent שם את תצוגת ה-3D בתוך אלמנט אחד, ליד HTML רגיל. frame() מתאים קופסה של יחידות עולם לכל גודל ווידג׳ט ומוחל מחדש בשינוי גודל. במחשבים איטיים הבמה מורידה לבד את הרזולוציה והזוהר.

T.vessel({ shape, radius, height })

כלי זכוכית: 'jar', 'bowl', 'vase' או 'glass', נראה מבחוץ ומבפנים. fill(0..1, color) מאיר אותו לקראת יעד.

T.orb({ image, radius, color })

גולת זכוכית עם תמונה בתוכה (תמונת מתנה, אווטאר): כך תמונה שטוחה הופכת לאובייקט תלת-ממדי שיכול ליפול ולהיערם.

T.physics(stage) · world.add()

פיזיקה לדברים עגולים: הם נופלים, קופצים, מתגלגלים, נערמים בתוך כלי וגולשים מעבר לשפה שלו. world.vessel(v), world.free(x, y, z, r), world.remove(body).

חומרים

העבר אחד כ-material: … : מתכות, אבני חן וזכוכית, קומיקס בהצללת toon (עם קו מתאר דיו), ו-holo, rainbow ו-lava מונפשים.

'gold''rosegold''silver''chrome''bronze''diamond''glass''ice''neon''plastic''candy''comic''holo''rainbow''lava'
סגנונות

עיבוד לכל הבמה: comic מוסיף קווי מתאר בדיו ונקודות halftone, retro מוסיף scanlines, cinematic מבצע תיקון צבע לתמונה.

'comic''retro''cinematic''none'
אפקטים

כל אחד מחזיר handle: קרא ל-stop(), kill() או remove() כשההתראה נגמרת.

T.fx.fireT.fx.lightningT.fx.sparksT.fx.shockwaveT.fx.comicBurstT.fx.speedLinesT.fx.confettiT.fx.shapesT.fx.rainT.fx.auraT.fx.embersT.fx.fogT.fx.rays
שם תלת-ממדי מזהב עם אש· השם של כל שולח מתנה באותיות 3D אמיתיות
var T, st;
TE.lib('three').then(function (lib) {
  T = lib;
  st = T.stage({ bloom: 0.6 });
  TE.on('gift', show);
  if (TE.demo) {
    var names = ['محمد الأسد', 'NightOwl', '𝓛𝓾𝓷𝓪'], i = 0;
    var next = function () { show({ user: { name: names[i++ % 3] } }); };
    next(); setInterval(next, 5000);
  }
});

async function show(ev) {
  var txt = await T.text3d(ev.user.name, { material: 'gold', maxWidth: 8, fallback: ev.user.username });
  st.add(txt); st.fit(Math.max(4, txt.userData.width + 1.5));
  txt.scale.setScalar(0.01); txt.rotation.y = -6;
  await T.animate(txt, { scale: 1, rotation: { y: 0 } }, { duration: 1100, ease: 'outBack' });
  var fire = T.fx.fire(st, { target: txt });
  T.fx.sparks(st, { at: { x: 0, y: 0, z: 0.5 }, count: 120 });
  var off = st.onFrame(function (dt, t) { txt.rotation.y = Math.sin(t) * 0.35; });
  await T.wait(2600);
  fire.kill(); off();
  await T.animate(txt, { scale: 0.01 }, { duration: 400, ease: 'inBack' });
  st.remove(txt);
}
תצוגה חיה
מתנת זכוכית תלת-ממדית· המתנה בתוך כרטיס זכוכית, השם בזכוכית זוהרת
var T, st;
TE.lib('three').then(function (lib) {
  T = lib;
  st = T.stage({ bloom: 0.55 });
  TE.on('gift', show);
  if (TE.demo) {
    var rose = 'https://p16-webcast.tiktokcdn.com/img/maliva/webcast-va/eba3a9bb85c33e017f3648eaf88d7189~tplv-obj.png';
    var next = function () { show({ user: { name: 'NightOwl' }, gift: { image: rose } }); };
    next(); setInterval(next, 5000);
  }
});

async function show(ev) {
  var card = await T.panel({ width: 3, height: 3, tint: '#9fdcff', image: ev.gift.image });
  var name = await T.text3d(ev.user.name, { size: 0.8, material: 'glass', maxWidth: 7 });
  card.position.y = 1; name.position.y = -1.3;
  st.add(card); st.add(name); st.fit(8);
  card.rotation.y = -Math.PI; card.scale.setScalar(0.05);
  await T.animate(card, { rotation: { y: 0 }, scale: 1 }, { duration: 1000, ease: 'outBack' });
  var off = st.onFrame(function (dt, t) { card.rotation.y = Math.sin(t) * 0.35; });
  await T.wait(3000);
  off(); st.remove(card); st.remove(name);
}
תצוגה חיה
08

Sandbox ומגבלות

ווידג׳טים רצים ב-iframe מבודד עם מדיניות אבטחת תוכן מחמירה, כך שווידג׳ט שבור או זדוני אף פעם לא יכול לגעת בחשבון שלך או בשאר הדף.

מותר
  • תמונות ו-GIF מרוחקים (תמונות מתנה של TikTok, אווטארים, כל URL)
  • Google Fonts + @font-face משלך
  • אודיו דרך new Audio(url)
  • בקשות ל-APIs של TokElements עצמו (למשל /api/files/…)
  • אנימציות CSS, SVG, canvas, Web Audio
  • תלת-ממד אמיתי ומודלי .glb שהועלו דרך TE.lib('three')
חסום
  • תגיות <script> חיצוניות / CDNs
  • fetch / XHR / WebSocket לשרתים אחרים
  • עוגיות, localStorage, גישה לדף האב
  • טעינת חבילות npm
09

דוגמאות

ווידג׳טים מלאים, מוכנים להעתקה. כל תצוגה היא חיה: אירועי דמו מופעלים כדי שתראה איך הוא מגיב.

תגובת אימוג׳י· מקפיץ את האימוג׳י כשהוא נשלח בצ׳אט
var img = document.getElementById('emote');
// fires for every emote — use TE.onSticker('<id>', …) for one specific one
TE.on('sticker', function (ev) {
  img.src = ev.url;
  img.classList.remove('show'); void img.offsetWidth; img.classList.add('show');
});
תצוגה חיה
סרגל יעד עוקבים· מקשר סרגל לנתון חי
var target = 200;                       // ← your goal
TE.on('metrics', function (m) {
  var pct = Math.min(100, m.follows / target * 100);
  document.getElementById('fill').style.width = pct + '%';
  document.getElementById('txt').textContent = m.follows + ' / ' + target;
});
תצוגה חיה