ส่งข้อความโดยตรง API

คุณสามารถส่งข้อความตรงไปยังผู้ใช้คนอื่นภายใน zepeto world โดยใช้ api ส่งข้อความตรง (dm) เมื่อใช้ api ส่งข้อความตรง (dm) ในโลกที่เปิดใช้งานแล้ว จะมีลิงก์เพื่อเข้าสู่โลกโดยอัตโนมัติที่ด้านล่างของข้อความ ทำให้เหมาะสำหรับการโปรโมตโลก โปรดแน่ใจว่าคุณปฏิบัติตามข้อควรระวังเมื่อใช้งาน ติดตั้ง window → package manager → zepeto world package กรุณาติดตั้งเวอร์ชัน 1 21 14 หรือสูงกว่าก่อน หลังจากนั้น กรุณาติดตั้งแพ็คเกจ ‘zepeto module’ ที่มีเวอร์ชัน 1 0 7 หรือสูงกว่า ตรวจสอบให้แน่ใจว่าแอป zepeto กำลังทำงานในเวอร์ชัน 3 46 000 หรือสูงกว่า api ส่งข้อความตรง ในการใช้ api ส่ง dm ให้เพิ่มคำสั่งนำเข้าด้านล่างนี้ import { socialservice } from 'zepeto module social'; ฟังก์ชันหลักในการส่ง dm ประกาศ public static openpopupdirectmessage($sendmessage string, $userids? string\[], $oncomplete? system action$1)\ void; พารามิเตอร์ พารามิเตอร์ คำอธิบาย sendmessage นี่คือพารามิเตอร์ที่จำเป็น นี่คือเนื้อหาของข้อความที่คุณต้องการส่ง หากมันว่างเปล่าหรือไม่มีเนื้อหา การส่งจะถือเป็นความล้มเหลว userids นี่คือพารามิเตอร์ที่ไม่จำเป็น หากคุณส่ง userids \ ui การเลือกจะถูกกำหนดด้วยรายการ user id ที่เกี่ยวข้อง เมื่อไม่ส่ง userids หรือส่งรายการว่าง \ ui การเลือกจะถูกสร้างขึ้นด้วยรายการติดตาม/ติดตามของผู้ใช้ที่ส่งข้อความ oncomplete นี่คือ callback ที่จะถูกเรียกเมื่อการส่งข้อความเสร็จสิ้นหรือล้มเหลว สถานะป๊อปอัพข้อความตรง การตอบสนอง คำอธิบาย ยกเลิก เมื่อป๊อปอัพถูกปิดด้วยตนเองหรือหากการส่งล้มเหลว ส่งเสร็จสิ้น เมื่อคำขอส่งเสร็จสิ้นและมันปิดตัวลง สถานการณ์ตามรหัสข้อผิดพลาด การตอบสนอง คำอธิบาย 31002 สิ่งนี้เกิดขึ้นหากมี userid ที่ไม่ถูกต้องอย่างน้อยหนึ่งรายการ (userid ที่ไม่มีอยู่) รวมอยู่เมื่อป้อนรายการ user id ในพารามิเตอร์ userids 37011 สิ่งนี้เกิดขึ้นเมื่อคุณพยายามส่งข้อความในขณะที่อยู่ภายใต้บัญชีผู้เยี่ยมชม 8001 สิ่งนี้เกิดขึ้นเมื่อคุณส่งข้อความเดียวกันซ้ำ ๆ ติดต่อกัน มันสามารถส่งได้ครั้งละ 10 วินาที 2001 สิ่งนี้เกิดขึ้นเมื่อเนื้อหาของข้อความในฟิลด์ ‘ส่ง’ ว่างเปล่า มีเพียงช่องว่าง หรือเกิน 1000 ตัวอักษร 0 กรณีข้อผิดพลาดการเชื่อมต่อเครือข่าย เช่น การตัดการเชื่อมต่อเครือข่าย ความไม่เสถียรของการเชื่อมต่อ และสถานการณ์ข้อผิดพลาดทั่วไปอื่น ๆ 1 ข้อผิดพลาดที่ไม่สามารถระบุได้ ตัวอย่างการใช้งาน กรอกผู้ส่งโดยตรงและส่ง 1\) กรุณาเพิ่มปุ่มส่ง dm ลงใน canvas 2\) กรุณาเขียนโค้ดตัวอย่างตามด้านล่างนี้ import { zepetoscriptbehaviour } from 'zepeto script'; import { socialservice, directmessagepopupstate } from 'zepeto module social'; import { button } from "unityengine ui"; import { worldservice } from 'zepeto world'; export default class senddirectmessage extends zepetoscriptbehaviour { // ตัวแปรเพื่อเก็บข้อความตรง public message string; // อาร์เรย์ของ id ผู้ใช้เพื่อส่งข้อความตรงไปยัง public userids string\[]; // อ้างอิงไปยังส่วนประกอบ ui ปุ่ม public senddmbutton button; start() { this senddmbutton onclick addlistener(() => { // ตรวจสอบว่าหมายเลข id ของฉันรวมอยู่ในอาร์เรย์ userids หรือไม่และคืนค่าหากรวมอยู่ if (this userids includes(worldservice userid)) { console log("userids มี userid ของฉัน"); return; } // เปิดป๊อปอัพเพื่อส่งข้อความตรงโดยใช้ socialservice socialservice openpopupdirectmessage(this message, this userids, (popupstate directmessagepopupstate) => { // ตรวจสอบสถานะของป๊อปอัพข้อความตรง if (popupstate === directmessagepopupstate cancel) { console log("คุณปิดป๊อปอัพหรือไม่สามารถส่งข้อความได้"); } else if (popupstate === directmessagepopupstate sendcomplete) { console log("ข้อความ dm ถูกส่งสำเร็จและป๊อปอัพถูกปิด "); } }); }); } } 3\) หลังจากเขียนสคริปต์เสร็จแล้ว ให้กลับไปที่ unity editor และลากปุ่มใน inspector เพื่อตั้งค่า กรอกเนื้อหาข้อความและ userid ของผู้ใช้เป้าหมายสำหรับข้อความ แสดงได้สูงสุด 20 คนใน ui ดังนั้นกรอกข้อมูลได้สูงสุด 20 คน 4\) เมื่อคุณกดปุ่มส่ง dm ui รายชื่อเพื่อนจะปรากฏขึ้น เลือกผู้ใช้เป้าหมายและคลิกส่ง 5\) หากการส่ง dm สำเร็จ ui toast จะปรากฏขึ้นเพื่อแสดงความสำเร็จ และจะมีการบันทึกโดยสคริปต์ตัวอย่าง 6\) นอกจากนี้ยังมี dm มาถึงสำหรับ targetuser หากเกิดข้อผิดพลาด เช่น การส่งข้อความต่อเนื่องหรือเนื้อหาข้อความว่าง การส่ง dm จะถูกประมวลผลว่าเป็นความล้มเหลว ส่งโดยใช้ ui รายชื่อผู้ติดตาม/ผู้ติดตาม 1\) กรุณาเพิ่มปุ่มลงใน canvas 2\) กรุณาเขียนโค้ดตัวอย่างตามด้านล่าง หากคุณส่งรายการว่างไปยังพารามิเตอร์ targetuserid ui รายชื่อผู้ติดตาม/ผู้ติดตามจะปรากฏขึ้น import { zepetoscriptbehaviour } from 'zepeto script'; import { socialservice, directmessagepopupstate } from 'zepeto module social'; import { button } from "unityengine ui"; export default class senddirectmessage extends zepetoscriptbehaviour { // ตัวแปรเพื่อเก็บข้อความตรง public message string; // อ้างอิงไปยังส่วนประกอบ ui ปุ่ม public senddmbutton button; // ตัวแปรส่วนตัวเพื่อเก็บอาร์เรย์ของ id ผู้ใช้ เริ่มต้นเป็น null private emptyids string\[]; start() { this senddmbutton onclick addlistener(() => { // เปิดป๊อปอัพเพื่อส่งข้อความตรงโดยใช้ socialservice // ใช้เนื้อหาข้อความของคลาสและอาร์เรย์ว่างของ id ผู้ใช้ socialservice openpopupdirectmessage(this message, this emptyids, (popupstate directmessagepopupstate) => { // ตรวจสอบสถานะที่ส่งกลับของป๊อปอัพข้อความตรง if (popupstate === directmessagepopupstate cancel) { console log("คุณปิดป๊อปอัพหรือไม่สามารถส่งข้อความได้"); } else if (popupstate === directmessagepopupstate sendcomplete) { console log("ข้อความ dm ถูกส่งสำเร็จและป๊อปอัพถูกปิด "); } }); }); } } 3\) หลังจากเขียนสคริปต์เสร็จ ให้กลับไปที่ unity editor และลากปุ่มใน inspector เพื่อตั้งค่า จากนั้นกรุณาใส่เนื้อหาของข้อความ 4\) เมื่อคุณกดปุ่มส่ง dm ui ของผู้ติดตาม/ผู้ติดตามจะปรากฏขึ้น เลือกผู้ใช้เป้าหมายและคลิกส่ง (สามารถเลือกได้สูงสุด 5 คน) คุณสามารถส่ง dm ได้สูงสุด 5 คนในครั้งเดียว คุณไม่สามารถส่ง dm ไปหาตัวเองได้ จำนวนผู้ติดตาม/ผู้ติดตามจริงอาจแตกต่างจากจำนวนผู้ใช้ที่แสดงในป๊อปอัพส่ง dm นี่เป็นเพราะผู้ใช้ที่สามารถเลือกได้จะถูกกรองและแสดงผล หากคุณเลือกผู้ใช้ที่บล็อกการรับ dm จะถือว่าเป็นความล้มเหลวและ dm จะไม่ถูกส่ง หากคุณเรียกใช้ api ส่ง dm บ่อยเกินไป จะมีการจำกัดและการส่งจะล้มเหลว คุณสามารถส่งได้ครั้งละ 10 วินาที กรุณาอย่าส่ง dm โดยไม่เลือก หากข้อความที่คุณส่งมี url จะไม่ทำงานอย่างถูกต้อง ดังนั้นการส่งข้อความที่มี url จึงถูกห้าม หากข้อความที่ส่งเป็นค่าว่างหรือว่างเปล่า จะถือว่าเป็นความล้มเหลว กรุณาเขียนเนื้อหาของข้อความให้ชัดเจน