ตัวแปรเทมเพลต

ตัวแปรทั้งหมดที่คุณสามารถใส่ในข้อความของขั้นตอนแอคชัน ข้อมูลที่แต่ละตัวแปรบรรจุ และทริกเกอร์ที่ส่งข้อมูล

พิมพ์ตัวแปรภายในวงเล็บปีกกา เช่น {name} แล้ว Vfinity จะแทนที่ค่าจริงให้โดยอัตโนมัติเมื่อขั้นตอนเริ่มทำงาน: เช่น "ขอบคุณ {name} สำหรับ {gift}!" จะกลายเป็น "ขอบคุณ Mika สำหรับ Rose!"

ข้อความเสียงพูดที่แทนที่ชื่อผู้ชมจริง และอ่านออกเสียงด้วยเสียงเฉพาะตัวของพวกเขา

ตัวแปรทั่วไปสำหรับทุกทริกเกอร์

ตัวแปร	ข้อมูลที่บรรจุ	ส่งโดย
`{name}`	ชื่อที่แสดงของผู้ชม หรือชื่อ @handle หากไม่มีชื่อแสดง	ทริกเกอร์ใดก็ตามที่มีข้อมูลผู้ชม
`{nickname}`	ชื่อที่แสดงของผู้ชม	ทริกเกอร์ใดก็ตามที่มีข้อมูลผู้ชม
`{uniqueId}`	ชื่อ @handle ของผู้ชม (ไม่มีเครื่องหมาย @)	ทริกเกอร์ใดก็ตามที่มีข้อมูลผู้ชม
`{points}`	ยอดคะแนนสะสมของผู้ชม หลังจากหักค่าคะแนนแล้ว	ทริกเกอร์ใดก็ตามที่มีข้อมูลผู้ชม
`{trigger}`	ชื่อของทริกเกอร์ API หรือประเภทของทริกเกอร์ เช่น `gift` หรือ `chat`	ทุกทริกเกอร์
`{gift}`	ชื่อของขวัญ	ของขวัญ
`{count}`	จำนวนคอมโบของของขวัญ หรือจำนวนยอดถูกใจ	ของขวัญ, ถูกใจ
`{diamonds}`	มูลค่าเพชรของของขวัญหนึ่งชิ้น	ของขวัญ
`{totalDiamonds}`	มูลค่าเพชรรวมของทั้งคอมโบ: เพชร × จำนวน	ของขวัญ
`{likes}`	จำนวนยอดถูกใจในอีเวนต์ครั้งนี้	ถูกใจ
`{totalLikes}`	ยอดถูกใจสะสมรวมของทั้งห้องไลฟ์	ถูกใจ, หมุดหมายยอดถูกใจของห้อง
`{comment}`	ข้อความแชต หรือข้อความที่มากับของขวัญหรือรางวัล	ข้อความแชต, แชตครั้งแรกในสตรีมนี้, ของขวัญ, แต้มช่อง Twitch
`{args}`	ข้อความทั้งหมดที่อยู่ถัดจากคำสั่ง	ข้อความแชต
`{arg1}` ถึง `{arg9}`	คำที่ 1 ถึงคำที่ 9 ถัดจากคำสั่ง หรือกลุ่มแคปเจอร์ของเรกูลาร์เอ็กซ์เพรสชัน	ข้อความแชต

ยอดคะแนนสะสมของผู้ชมจะแยกตามแต่ละแพลตฟอร์ม ดังนั้นชื่อเดียวกันบน TikTok LIVE และ Twitch จะมียอดคะแนนสองยอดแยกกัน

ตัวแปรเฉพาะของแต่ละทริกเกอร์

ตัวแปร	ข้อมูลที่บรรจุ	ทริกเกอร์
`{months}`	จำนวนเดือนที่สมัครสมาชิก หรือจำนวนเดือนที่เป็นสมาชิก YouTube	การสมัครสมาชิก
`{rewardName}`, `{rewardCost}`	ชื่อรางวัล และจำนวนแต้มช่องที่ใช้แลก	แต้มช่อง Twitch
`{rewardId}`, `{redemptionId}`	ID ของรางวัลใน Twitch และ ID ของการแลกครั้งนี้	แต้มช่อง Twitch
`{viewers}`	จำนวนผู้ชมที่มาพร้อมการเรด หรือจำนวนผู้ชมในห้อง	เรด, หมุดหมายจำนวนผู้ชม
`{followers}`	จำนวนผู้ติดตามของคุณ	หมุดหมายจำนวนผู้ติดตาม
`{coins}`	จำนวนเหรียญที่ผู้ส่งใส่ในกล่องสมบัติ	กล่องสมบัติ
`{emoteUrl}`	ที่อยู่รูปภาพของอีโมตแรก	อีโมตสมาชิก
`{questionText}`	ข้อความคำถาม	คำถาม LIVE
`{phase}`, `{level}`, `{total}`	ช่วง เลเวล และยอดรวมของไฮป์เทรน	ไฮป์เทรน
`{value}`, `{target}`, `{cycle}`	ค่าปัจจุบัน เป้าหมาย และรอบของเป้าหมายที่ตั้งวนซ้ำ	ถึงเป้าหมายโอเวอร์เลย์
`{result}`	ตัวเลือกที่วงล้อหมุนไปหยุด	ผลการหมุนวงล้อ
`{winner}`, `{tickets}`, `{entrants}`	ชื่อผู้ชนะ จำนวนตั๋ว และจำนวนผู้เข้าร่วมทั้งหมด	ผู้ชนะการแจกของ
`{team}`, `{score}`, `{otherScore}`	ทีมที่ชนะ คะแนนของทีมชนะ และคะแนนของอีกทีม	ชนะการชักเย่อ
`{level}`, `{levelName}`	เลเวลที่บรรลุ ทั้งตัวเลขและชื่อเลเวล	ถึงเลเวลไฮป์

ผู้ชนะการแจกของ จะส่งชื่อผู้ชนะในฐานะผู้ชมด้วย ดังนั้น {name} จึงใช้งานในทริกเกอร์นี้ได้เช่นกัน ในทริกเกอร์ ของขวัญ ตัวแปร {comment} จะเก็บข้อความที่ส่งมากับ Cheer ของ Twitch ของขวัญ Kicks หรือ Super Chat ของ YouTube หรือข้อความที่ผู้ชมพิมพ์ตอนแลกรางวัล

ฟิลด์ของทริกเกอร์ API

ทริกเกอร์ API จะแปลงฟิลด์ระดับบนสุดของ data ที่ส่งเข้ามาให้กลายเป็นตัวแปร หากฟิลด์นั้นเป็นข้อความ ตัวเลข หรือจริง/เท็จ รองรับสูงสุด 50 ฟิลด์แรก โดยออบเจกต์ซ้อนจะไม่ถูกนำมาแปลง เช่น หากส่ง {"name":"raid_alert","data":{"user":"Mika"}} ขั้นตอนแอคชันสามารถใส่ {user} ได้ทันที

แบตเทิล, เป้าหมาย TikTok LIVE, คำถาม LIVE และ ซูเปอร์แฟน จะดึงฟิลด์ระดับบนสุดของ TikTok ออกมาในลักษณะเดียวกัน เช่น {outcome} บนแบตเทิล หรือ {description} และ {progress} บนเป้าหมาย LIVE

จุดที่สามารถนำตัวแปรไปใช้งานได้

ขั้นตอนหรือตำแหน่ง	ช่องกรอก	วิธีการนำค่าไปใส่
พูดข้อความกำหนดเอง	ข้อความที่จะพูด	แปลงเป็นเสียงพูด หลังจากผ่านตัวกรอง TTS
ควบคุม OBS, พิมพ์ข้อความลงในแหล่งข้อความ	ข้อความ	ข้อความธรรมดา
เว็บฮุก HTTP	URL / ID แอคชัน	เข้ารหัสแบบเปอร์เซ็นต์ (Percent-encoded) เฉพาะในส่วนพาธและคิวรี
เว็บฮุก HTTP	เนื้อหา JSON / อาร์กิวเมนต์	ภายในค่าข้อความของ JSON
แอคชัน Streamer.bot	เนื้อหา JSON / อาร์กิวเมนต์	ภายในค่าข้อความของ JSON
คำสั่งแอป	ค่า หรือ ค่า (JSON)	ภายในค่าข้อความ

เว็บฮุกจะส่งไปยังโฮสต์ที่คุณพิมพ์ไว้เสมอ: ตัวแปรสามารถเปลี่ยนพาธและคิวรีได้ แต่เปลี่ยนเซิร์ฟเวอร์ไม่ได้ ใน JSON จะแทนที่เฉพาะค่าข้อความเท่านั้น ข้อความของผู้ชมจึงไม่มีวันไปเพิ่มฟิลด์ใหม่หรือทำลายโครงสร้างของ JSON

กฎการแทนที่ค่า

ตัวแปรที่ไม่มีข้อมูลส่งมา เช่น {gift} ในอีเวนต์การกดติดตาม จะกลายเป็นข้อความว่างเปล่า
ตัวแปรที่ Vfinity ไม่รู้จัก เช่น {banana} จะคงตัวอักษรไว้อย่างเดิมทุกประการ
ในเสียงพูดและข้อความธรรมดา เครื่องหมายขึ้นบรรทัดใหม่จะกลายเป็นช่องว่าง และอักขระควบคุมจะถูกลบออก โดยค่าหนึ่งค่าจะถูกตัดทอนที่ 500 ตัวอักษร
การแทนที่จะเกิดขึ้นเพียงครั้งเดียว ผู้ชมที่มีชื่อเป็นคำว่า {name} จะแสดงเป็น {name} และไม่ถูกแทนที่ซ้ำรอบสอง
ชื่อตัวแปรต้องตรงตามตัวพิมพ์เล็ก-ใหญ่: {Name} จะไม่เหมือนกับ {name}

ข้อความของการแจ้งเตือน

การ์ดแจ้งเตือนมีตัวแปรเฉพาะสำหรับ ข้อความกำหนดเอง โดยจะดึงข้อมูลมาจากการแจ้งเตือนนั้นโดยตรง

ตัวแปร	ข้อมูลที่บรรจุ
`{name}`	ชื่อผู้ส่ง แสดงด้วยสีเน้น
`{gift}`, `{count}`	ชื่อของขวัญและจำนวนชิ้น
`{diamonds}`, `{totalDiamonds}`	มูลค่าของขวัญหนึ่งชิ้น และมูลค่ารวมทั้งคอมโบ
`{likes}`, `{totalLikes}`	หมุดหมายยอดถูกใจที่ผ่าน และยอดรวมของห้อง
`{months}`	จำนวนเดือนที่สมัครสมาชิก ในการแจ้งเตือนสมาชิก
`{viewers}`	จำนวนผู้ชมที่มาด้วยกัน ในการแจ้งเตือนการเรด