ทริกเกอร์
ทริกเกอร์ทุกประเภทที่อีเวนต์สามารถรอคอย พร้อมช่องกรอก แหล่งที่มา และตัวแปรที่ส่งต่อ
ทริกเกอร์ทั้งหมดในเมนู ประเภทอีเวนต์ ของตัวแก้ไขอีเวนต์ พร้อมช่องกรอกที่เพิ่มเข้ามา แพลตฟอร์มที่ส่งข้อมูล และตัวแปรเทมเพลตที่ขั้นตอนสามารถนำไปใช้งานได้
เมนูจะเริ่มต้นจากสิ่งที่เกิดขึ้นบนสตรีม ตามด้วยสองทริกเกอร์ที่จับคู่ด้วยข้อความที่คุณพิมพ์: ทริกเกอร์ API และ ข้อความแชต สำหรับคำแนะนำในการเลือกดูได้ที่ เลือกทริกเกอร์
เลือกประเภทอีเวนต์และขั้นตอน ช่องกรอกจะเปลี่ยนตามตัวเลือกเหมือนในแอป
กิจกรรมของผู้ชม
| ทริกเกอร์ | ทำงานเมื่อ | ส่งโดย | ช่องกรอกเฉพาะ |
|---|---|---|---|
| ของขวัญ | มีของขวัญเข้ามา หรือคอมโบจบลง | TikTok LIVE, Twitch, Kick, YouTube | ชื่อของขวัญ, แคตตาล็อก, การจับคู่, มูลค่าอย่างน้อย |
| ถูกใจ | ผู้ชมแตะหน้าจอ | TikTok LIVE | ไม่มี |
| ติดตาม | มีคนกดติดตามคุณ | TikTok LIVE, Twitch, Kick | ไม่มี |
| แชร์ | มีคนแชร์ไลฟ์ | TikTok LIVE | ไม่มี |
| ข้อความแชต | ข้อความแชตตรงกับข้อความของคุณ | TikTok LIVE, Twitch, Kick, YouTube | ข้อความทริกเกอร์, โหมดการจับคู่, ตรงตามตัวพิมพ์เล็ก-ใหญ่, คะแนนที่ต้องใช้ต่อหนึ่งคำสั่ง, ใช้อาร์กิวเมนต์แรกของคำสั่งเพื่อเคลื่อนย้ายโมเดล |
| แชตครั้งแรกในสตรีมนี้ | ข้อความแรกของผู้ชมในสตรีมนี้ | TikTok LIVE, Twitch, Kick, YouTube | ไม่มี |
| ผู้ชมเข้าร่วม | ผู้ชมเข้ามาในห้องไลฟ์ | TikTok LIVE | ไม่มี |
| การสมัครสมาชิก | ผู้ชมสมัครสมาชิก หรือมีผู้ชมเป็นสมาชิก YouTube ใหม่หรือถึงไมล์สโตนสมาชิก | TikTok LIVE, Twitch, Kick, YouTube | ไม่มี |
| ซูเปอร์แฟน | ผู้ชมกลายเป็นซูเปอร์แฟน | TikTok LIVE | ไม่มี |
| อีโมตสมาชิก | สมาชิกส่งอีโมต | TikTok LIVE | ไม่มี |
| กล่องสมบัติ | มีผู้วางกล่องสมบัติ | TikTok LIVE | ไม่มี |
| คำถาม LIVE | ผู้ชมส่งคำถามในไลฟ์ | TikTok LIVE | ไม่มี |
| เรด Twitch เท่านั้น | มีช่องอื่นเรดเข้ามา | Twitch | ไม่มี |
| แต้มช่อง Twitch Twitch เท่านั้น | ผู้ชมแลกรางวัลแต้มช่อง | Twitch | เมนูรางวัล, รางวัลใดก็ได้, รีเฟรชรางวัล |
ผู้ชมเข้าร่วม จะทำงานหนึ่งครั้งต่อคนในทุก ๆ 30 วินาที เพื่อไม่ให้คนที่สัญญาณหลุดแล้วเข้ามาใหม่เรียกใช้งานซ้ำ แชตครั้งแรกในสตรีมนี้ จดจำผู้ชมได้สูงสุด 50,000 คนต่อสตรีม
ของขวัญจาก Twitch, Kick และ YouTube
การสนับสนุนจาก Twitch, Kick และ YouTube จะส่งเข้ามาที่ทริกเกอร์ ของขวัญ ตามมูลค่าเพชรที่คุณกำหนดใน การตั้งค่าแต้มมูลค่าของอีเวนต์ พิมพ์ชื่อเหล่านี้ในช่อง ชื่อของขวัญ เพื่อตอบสนองเฉพาะรายการนั้น:
| ชื่อของขวัญ | ความหมาย |
|---|---|
Cheer | บิตส์ของ Twitch |
Gift Sub | สมาชิกที่มอบเป็นของขวัญบน Twitch หรือ Kick หรือสมาชิก YouTube ที่ถูกมอบให้ |
Kicks | เหรียญของขวัญของ Kick |
Super Chat | Super Chat ของ YouTube มีมูลค่าเป็นเพชรตามจำนวนเงิน |
Super Sticker | Super Sticker ของ YouTube มีมูลค่าเป็นเพชรตามจำนวนเงิน |
| ชื่อของของขวัญนั้น | ของขวัญ YouTube Jewels ไม่มีมูลค่าเพชร |
| ชื่อของรางวัล | การแลกแต้มช่อง Twitch หรือรางวัล Kick |
ข้อความที่ส่งมากับ Cheer ของขวัญ Kicks หรือ Super Chat จะอยู่ใน {comment} ข้อความของ Super Chat ยังเข้ามาเป็นข้อความแชตด้วย ต่อจากของขวัญ
แต้มช่อง Twitch และสมาชิก YouTube
แต้มช่อง Twitch จับคู่รางวัลด้วย ID จึงยังทำงานได้แม้คุณเปลี่ยนชื่อรางวัลบน Twitch รางวัลใดก็ได้ จับคู่กับการแลกทุกครั้ง และการแลกที่ Twitch รายงานซ้ำสองครั้งจะทำงานเพียงครั้งเดียว เมนูจะแสดงรางวัลที่คุณสร้างเองพร้อมจำนวนแต้มที่ใช้แลก ขณะที่ Twitch เชื่อมต่ออยู่และลงชื่อเข้าใช้ด้วยบัญชีเจ้าของช่อง
บน YouTube สมาชิกใหม่และไมล์สโตนสมาชิกจะเรียกทริกเกอร์ การสมัครสมาชิก รวมถึงผู้ชมแต่ละคนที่ได้รับสมาชิกเป็นของขวัญด้วย สมาชิกของช่องจะนับเป็นสมาชิก (subscriber) ใน ใครสั่งงานนี้ได้
ช่วงเวลาสำคัญของสตรีมและหมุดหมาย
| ทริกเกอร์ | ทำงานเมื่อ | ช่องกรอกเฉพาะ |
|---|---|---|
| สตรีมเริ่มต้น | เริ่มต้นการไลฟ์ใหม่บนแพลตฟอร์มใดก็ตาม หรือไลฟ์ YouTube ที่ตั้งเวลาไว้ซึ่งคุณเข้าร่วมล่วงหน้าเริ่มออกอากาศ | ไม่มี |
| สตรีมสิ้นสุด | การไลฟ์สิ้นสุดลง บน YouTube จะทำงานภายในหนึ่งนาที | ไม่มี |
| หมุดหมายยอดถูกใจของห้อง | ยอดถูกใจรวมของห้องผ่านเกณฑ์ที่กำหนด | เกณฑ์ขั้นต่ำ, ทำงานซ้ำทุกเท่าตัว |
| หมุดหมายจำนวนผู้ชม | จำนวนผู้ชมในห้องผ่านเกณฑ์ที่กำหนด | เกณฑ์ขั้นต่ำ, ทำงานซ้ำทุกเท่าตัว |
| หมุดหมายจำนวนผู้ติดตาม | จำนวนผู้ติดตามของคุณผ่านเกณฑ์ที่กำหนด | เกณฑ์ขั้นต่ำ, ทำงานซ้ำทุกเท่าตัว |
| แบตเทิล | แบตเทิล TikTok เริ่มขึ้น อัปเดต หรือสิ้นสุด | ช่วงของแบตเทิล, ผลของแบตเทิล (ไม่บังคับ) |
| เป้าหมาย TikTok LIVE | เป้าหมาย TikTok LIVE ของคุณเปลี่ยนแปลง | เฉพาะเมื่อบรรลุเป้าหมาย LIVE แล้วเท่านั้น |
| ไฮป์เทรน Twitch เท่านั้น | ไฮป์เทรนเริ่มต้นขึ้นหรือสิ้นสุดลง | ช่วงของแบตเทิล: begin หรือ end |
| ทุก ๆ สองสามนาที | ตัวนับเวลานับครบกำหนด | รันทุก ๆ, สุ่มเวลาเพิ่ม, เฉพาะขณะกำลังไลฟ์เท่านั้น |
เกณฑ์ขั้นต่ำ เริ่มต้นที่ 100 และรับจำนวนเต็มตั้งแต่ 1 ขึ้นไป หมุดหมายจะอ่านค่าของห้องเมื่อคุณเข้าร่วมและเริ่มนับจากจุดนั้น ทำให้การเข้าร่วมสตรีมที่กำลังดำเนินอยู่จะไม่ย้อนรันหมุดหมายที่ผ่านมาแล้ว หากไม่เลือก ทำงานซ้ำทุกเท่าตัว จะทำงานครั้งเดียวต่อสตรีม หมุดหมายยอดถูกใจของห้อง จะอ่านยอดถูกใจของ TikTok จึงไม่ทำงานบน Twitch, Kick และ YouTube
ช่วงของแบตเทิล มีตัวเลือก start, progress และ end ส่วน ผลของแบตเทิล (ไม่บังคับ) มี ไม่มี, win, lose และ draw
เรด, ไฮป์เทรน และ แต้มช่อง Twitch จะปรากฏในเมนูเมื่อเคยเชื่อมต่อ Twitch สำเร็จอย่างน้อยหนึ่งครั้ง
ทุก ๆ สองสามนาที
| ช่องกรอก | ช่วงค่า | ค่าเริ่มต้น |
|---|---|---|
| รันทุก ๆ | 1–240 นาที พร้อม ปุ่มเลือกด่วน 5, 10, 15, 30 และ 60 | 10 นาที |
| สุ่มเวลาเพิ่ม | 0 จนถึงความยาวของช่วงเวลานั้น (นาที) | 0 |
| เฉพาะขณะกำลังไลฟ์เท่านั้น | เปิด หรือ ปิด | เปิด |
รอบแรกจะเริ่มขึ้นหลังผ่านไปหนึ่งช่วงเวลานับตั้งแต่เริ่มนับถอยหลัง ไม่เริ่มในทันที รอบที่ตรงกับช่วงที่ Vfinity หยุดพักอยู่จะถูกข้ามไป และปุ่มฉุกเฉิน Panic จะเริ่มนับเวลาใหม่ทั้งหมดตั้งแต่ต้น
มินิเกมและวิดเจ็ตโอเวอร์เลย์
ทริกเกอร์เหล่านี้จะทำงานเมื่อวิดเจ็ตในแท็บ โอเวอร์เลย์ ได้ผลลัพธ์
| ทริกเกอร์ | ทำงานเมื่อ | ช่องคีย์ใช้กรองตาม |
|---|---|---|
| ถึงเป้าหมายโอเวอร์เลย์ | วิดเจ็ตเป้าหมายบรรลุยอดที่ตั้งไว้ | ID วิดเจ็ตของเป้าหมาย เช่น goal1 |
| ตัวจับเวลานับถึงศูนย์ | ตัวนับเวลานับถึงศูนย์ หรือตัวนับเดินหน้านับถึงเป้าหมาย | เว้นว่างไว้ |
| ผลการหมุนวงล้อ | วงล้อเสี่ยงโชคหยุดหมุน | ID ผลลัพธ์ของตัวเลือกนั้น |
| ผู้ชนะการแจกของ | วงล้อแจกของหยุดที่ผู้ชนะ | ไม่มีช่องคีย์ |
| ชนะการชักเย่อ | จบรอบชักเย่อโดยมีทีมชนะ | 1, 2 หรือชื่อทีม |
| ถึงเลเวลไฮป์ | มาตรวัดไฮป์ไต่ระดับขึ้นสู่เลเวลใหม่ | ตัวเลขเลเวล 1–5 หรือชื่อเลเวล |
ช่องคีย์คือ ID วิดเจ็ตหรือคีย์ผลลัพธ์ (เว้นว่างเพื่อจับคู่ทั้งหมด) ชื่อทีมและเลเวลจะจับคู่โดยไม่คำนึงถึงตัวพิมพ์เล็ก-ใหญ่ มาตรวัดไฮป์ต้องลดลงต่ำกว่าระดับเลเวล 10% ก่อนจึงจะเรียกทริกเกอร์เลเวลเดิมซ้ำได้
ข้อความที่คุณพิมพ์
| ทริกเกอร์ | ช่องกรอก | การจับคู่ |
|---|---|---|
| ทริกเกอร์ API | ชื่อทริกเกอร์ | ค่า name ของทริกเกอร์ที่ส่งมายัง Local API หรือ Trigger API โดยไม่คำนึงถึงตัวพิมพ์เล็ก-ใหญ่ |
| ข้อความแชต | ข้อความทริกเกอร์ | ข้อความแชต ตามโหมดการจับคู่ด้านล่าง |
โหมดการจับคู่ข้อความแชต
| โหมด | ข้อความจะตรงกันเมื่อ |
|---|---|
| มีคำว่า (ค่าเริ่มต้น) | มีข้อความนี้ปรากฏอยู่ส่วนใดก็ได้ภายในข้อความ |
| ตรงกันทุกตัวอักษร | ข้อความตรงกันทั้งหมดโดยไม่มีคำอื่น |
| ขึ้นต้นด้วย | ข้อความเริ่มต้นด้วยคำนี้ |
| คำสั่งและอาร์กิวเมนต์ | เริ่มต้นด้วยคำสั่ง เช่น !spin โดยคำต่อท้ายจะกลายเป็นอาร์กิวเมนต์ |
| เรกูลาร์เอ็กซ์เพรสชันแบบจำกัด | ตรงกับแพตเทิร์นที่กำหนด โดยกลุ่มที่จับคู่ได้จะกลายเป็นอาร์กิวเมนต์ |
ทำเครื่องหมายที่ ตรงตามตัวพิมพ์เล็ก-ใหญ่ เพื่อแยกความแตกต่างของตัวพิมพ์ใหญ่-เล็ก เรกูลาร์เอ็กซ์เพรสชันสามารถใช้แองเคอร์, คลาสของตัวอักษร, แคปเจอร์กรุ๊ป และการทำซ้ำคงที่ได้สูงสุด 32 ครั้ง
คะแนนที่ต้องใช้ต่อหนึ่งคำสั่ง กำหนดได้ตั้งแต่ 0–1,000,000 คะแนน ผู้ชมที่มีคะแนนไม่พอจะไม่เรียกให้อีเวนต์ทำงาน และคะแนนจะถูกคืนให้หากรายการที่รอในคิวถูกทิ้งก่อนเริ่มทำงาน
ใช้อาร์กิวเมนต์แรกของคำสั่งเพื่อเคลื่อนย้ายโมเดล ส่งอาร์กิวเมนต์แรกเข้าไปยังทุกขั้นตอน เคลื่อนย้ายโมเดล: การหมุน (°), ขนาด, ตำแหน่ง X หรือ ตำแหน่ง Y เช่น ผู้ชมพิมพ์ !spin 90 โมเดลจะหมุน 90° ค่าที่ไม่ใช่ตัวเลขจะหยุดอีเวนต์และไม่เสียคะแนน
ช่องกรอกทั่วไปที่ทุกทริกเกอร์ใช้งานร่วมกัน
อยู่ในส่วน การตั้งค่าขั้นสูง ของตัวแก้ไขอีเวนต์
| ช่องกรอก | ใช้กับ | ช่วงค่าหรือตัวเลือก |
|---|---|---|
| จำนวนของขวัญขั้นต่ำ, ยอดถูกใจขั้นต่ำ หรือ จำนวนขั้นต่ำ | ทุกทริกเกอร์ ยกเว้นหมุดหมายและ ทุก ๆ สองสามนาที | 0 ขึ้นไป |
| หน่วงเวลา (ms) | ทุกทริกเกอร์ | 0 ขึ้นไป ก่อนเริ่มรายการแอคชันทั้งหมด |
| โหมดการนับ | ทุกทริกเกอร์ ยกเว้น ทุก ๆ สองสามนาที | นับต่อผู้ชม หรือ นับรวมจากผู้ชมทุกคน |
| เปิดใช้งานการจำกัดอัตรา | ทุกทริกเกอร์ | จำนวนทริกเกอร์สูงสุด ใน หน้าต่างเวลา (วินาที) เริ่มต้นที่ 5 ครั้งใน 60 วินาที |
| ลักษณะตามจำนวน | ของขวัญ | ครั้งเดียวต่ออีเวนต์ของขวัญ, ทำซ้ำแอคชัน xN, ขยายระยะเวลา xN |
| นับ | ของขวัญ เมื่อเลือก นับรวมจากผู้ชมทุกคน | ของขวัญ หรือ เพชร |
| มูลค่าไม่เกิน (◆) | ของขวัญ | 1–1,000,000 เพชร หรือ ไม่จำกัด |
| มูลค่าของ | ของขวัญ | คอมโบทั้งหมด (ของขวัญ × จำนวน) หรือ ของขวัญชิ้นเดียว |
เมื่อตั้ง นับ เป็น เพชร อีเวนต์จะทำงานทุกครั้งที่เพชรรวมจากทุกคนผ่านเกณฑ์ เพชรที่ต้องสะสม สูงสุดไม่เกิน 20 ครั้งต่อหนึ่งคอมโบ
ปุ่ม การตั้งค่า ด้านล่างขั้นตอน จะเปิดกฎเกณฑ์: ใครสามารถเรียกใช้อีเวนต์นี้ได้, คูลดาวน์ และ คิวแอคชัน ดูคำอธิบายได้ที่ กฎและคูลดาวน์
| กฎ | ช่วงค่า | ค่าเริ่มต้น |
|---|---|---|
| ใครสามารถเรียกใช้อีเวนต์นี้ได้ | ผู้ติดตาม, เพื่อน, สมาชิก, ซูเปอร์แฟน, ผู้ดูแลห้อง, สมาชิกแฟนคลับ, ผู้ให้ของขวัญสูงสุด | ทุกคน |
| จำนวนผู้ให้ของขวัญสูงสุด | 1–100 | 3 |
| อนุญาตเสมอ, ไม่อนุญาตเสมอ | สูงสุด 200 รายชื่อต่อช่อง | ว่างเปล่า |
| ต่อผู้ชมแต่ละคน (วินาที), สำหรับทุกคน (วินาที) | 0–86,400 | 0 |
| ระหว่างช่วงคูลดาวน์ | ละเว้นทริกเกอร์ หรือ รันเมื่อสิ้นสุดการรอ | ละเว้นทริกเกอร์ |
| เลนของคิว (ชื่อเดียวกันรันตามลำดับ) | สูงสุด 64 ตัวอักษร | default |
| ลำดับความสำคัญของคิว (ตัวเลขสูงกว่ารันก่อน) | −1000 ถึง 1000 | 0 |
| ละทิ้งรายการที่รอในคิวหลังจากผ่านไปกี่วินาที | 1–3600 | 120 |
ตัวแปรที่แต่ละทริกเกอร์ส่งต่อ
ทุกทริกเกอร์ที่มีข้อมูลผู้ชมจะส่ง {name}, {nickname}, {uniqueId} และ {points} และทุกทริกเกอร์จะส่ง {trigger} นอกจากนี้แต่ละทริกเกอร์ยังส่งตัวแปรเฉพาะตัว:
| ทริกเกอร์ | ตัวแปรที่เพิ่ม |
|---|---|
| ของขวัญ | {gift}, {count}, {diamonds}, {totalDiamonds} และ {comment} เมื่อของขวัญมีข้อความมาด้วย |
| แต้มช่อง Twitch | {rewardName}, {rewardCost}, {rewardId}, {redemptionId} และ {comment} สำหรับรางวัลที่ให้ผู้ชมพิมพ์ข้อความ |
| ถูกใจ | {count}, {likes}, {totalLikes} |
| ข้อความแชต | {comment}, {args}, {arg1} ถึง {arg9} |
| แชตครั้งแรกในสตรีมนี้ | {comment} |
| การสมัครสมาชิก | {months} |
| เรด | {viewers} |
| กล่องสมบัติ | {coins} |
| อีโมตสมาชิก | {emoteUrl} |
| คำถาม LIVE | {questionText} |
| ไฮป์เทรน | {phase}, {level}, {total} |
| หมุดหมายยอดถูกใจของห้อง | {totalLikes} |
| หมุดหมายจำนวนผู้ชม | {viewers} |
| หมุดหมายจำนวนผู้ติดตาม | {followers} |
| ถึงเป้าหมายโอเวอร์เลย์ | {value}, {target}, {cycle} |
| ผลการหมุนวงล้อ | {result} |
| ผู้ชนะการแจกของ | {winner}, {tickets}, {entrants} |
| ชนะการชักเย่อ | {team}, {score}, {otherScore} |
| ถึงเลเวลไฮป์ | {level}, {levelName} |
| ทริกเกอร์ API | ทุกฟิลด์ระดับบนสุดที่เป็นข้อความ ตัวเลข หรือจริง/เท็จ ของ data ในทริกเกอร์ |
ดูรายการความหมายของแต่ละตัวแปรได้ใน ตัวแปรเทมเพลต