หน้านี้อธิบายวิธีส่งข้อความในฝั่งไคลเอ็นต์จาก ซึ่งเป็นส่วนเสริมที่ทำงานอยู่ใน iframe แผงด้านข้างลงใน ส่วนเสริมที่ใช้งานอยู่ใน ขั้น iframe เฟรมต่อเฟรม การรับส่งข้อความเกิดขึ้นในฝั่งไคลเอ็นต์เท่านั้น ดังนั้นการส่งข้อความจึงอยู่ใกล้ ในทันที
วิธีการส่งข้อความ
- จากแผงด้านข้างไปยังเวทีหลัก ให้ใช้
notifyMainStage()
await sidePanelClient.notifyMainStage("YOUR_MESSAGE");
- จากเวทีหลักไปยังแผงด้านข้าง ให้ใช้วิธี
notifySidePanel()
await mainStageClient.notifySidePanel("YOUR_MESSAGE");
payload
ความยาวต้องเป็นไปตามขีดจำกัดขนาดที่ระบุไว้
หากต้องการรับข้อความ ส่วนเสริมจะต้องสมัครใช้บริการ
เวลา
frameToFrameMessage
Callback ตัวอย่างโค้ดต่อไปนี้แสดงวิธีสมัครสมาชิก
การโทรกลับของ frameToFrameMessage:
sidePanelClient.on('frameToFrameMessage', (arg: FrameToFrameMessage) => {
// YOUR_CODE
});
ไฟล์ "ภาพเคลื่อนไหว" ตัวอย่างส่วนเสริมใน GitHub
จะมีตัวอย่างแบบเต็มของการรับส่งข้อความแบบเฟรมต่อเฟรม หลังจากที่กิจกรรมเริ่ม
แผงด้านข้างจะแจ้งเตือนบนเวทีหลักเมื่อผู้ใช้เปลี่ยนอินพุต
ขั้นตอนหลักยังติดตามการติดต่อกลับของ frameToFrameMessage ด้วย
เพื่อรับสถานะที่อัปเดต
หมายเหตุ
ข้อความแบบเฟรมต่อเฟรมที่ส่งโดยผู้เข้าร่วมรายหนึ่งๆ จะมองเห็นได้เท่านั้นโดย ผู้เข้าร่วมคนเดียวกัน หากต้องการส่งข้อความหรือบอกสถานะให้ผู้เข้าร่วมคนอื่นๆ ดูวิธีแชร์ส่วนเสริม
ระบบจะพยายามนำส่งข้อความเพียงครั้งเดียวเท่านั้น หากต้องการรับข้อความ แผงรับต้องเปิดอยู่และแอปต้องสมัครรับการเรียกกลับก่อนที่จะส่งข้อความ