สร้างโลกของคุณเอง
เศรษฐกิจ

ตัวอย่างการใช้งาน Product API

18min

ต่อไปนี้คือตัวอย่างการใช้ Product API เพื่อจัดการสกุลเงินโลกและผลิตภัณฑ์โลก

ตัวอย่างนี้ช่วยให้คุณเข้าใจพื้นฐานของ Product API และดำเนินการส่งและรับข้อความระหว่างเซิร์ฟเวอร์และไคลเอนต์ เพื่อให้คุณสามารถทดสอบการให้และหักสกุลเงินโลกและผลิตภัณฑ์ได้อย่างง่ายดาย

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

  • การให้สกุลเงินโลก
  • การหักสกุลเงินโลก
  • การให้ผลิตภัณฑ์โลกโดยไม่หักสกุลเงิน
  • การหักผลิตภัณฑ์โลก
Document image




การให้และหักสกุลเงินโลก

ด้านล่างนี้คือรหัสลูกค้าแบบเต็มสำหรับการจัดการการมอบและหักเงินสกุลเงินโลก และวิธีการดำเนินการ

สคริปต์ลูกค้าสกุลเงิน

CurrencyManagerSample




คำอธิบายสคริปต์ลูกค้าสกุลเงิน

  • เมื่อมีการโหลดตัวละคร ข้อความห้องจะถูกส่งไปยังเซิร์ฟเวอร์เพื่อโหลดยอดเงินสกุลเงินที่มีอยู่ จากนั้น UI จะถูกอัปเดตตามข้อมูลยอดเงินที่ได้รับจากเซิร์ฟเวอร์
TypeScript

  • เพื่ออำนวยความสะดวกในการแลกเปลี่ยนข้อความ, CurrencyMessage อินเตอร์เฟซถูกกำหนดขึ้น.
TypeScript

  • เมื่อผู้ใช้เพิ่มหรือลดสกุลเงินของตน, พวกเขาจะส่งคำขอไปยังเซิร์ฟเวอร์ในฐานะข้อความห้อง. มันรวมข้อมูลเกี่ยวกับว่าสกุลเงินใดที่จะเพิ่มหรือลดและโดยเท่าไหร่.
TypeScript

  • เซิร์ฟเวอร์จะประมวลผลการเพิ่มหรือลดสกุลเงินและส่งข้อมูลยอดเงินสุดท้ายไปยังลูกค้า ลูกค้าจะได้รับข้อมูลนี้และอัปเดต UI.
TypeScript




การมอบและหักผลิตภัณฑ์ในโลก

ด้านล่างนี้คือรหัสลูกค้าแบบเต็มสำหรับการจัดการการมอบและหักผลิตภัณฑ์ทั่วโลก และวิธีการดำเนินการ

สคริปต์ลูกค้าผลิตภัณฑ์

ProductManagerSample




คำอธิบายสคริปต์ลูกค้าผลิตภัณฑ์

  • เมื่อมีการโหลดตัวละคร ให้ใช้ InventoryService จาก ZEPETO.Inventory เพื่อโหลดสินค้าคงคลังเริ่มต้นของผลิตภัณฑ์ จากนั้นอัปเดต UI.
TypeScript

  • ในการส่งและรับข้อความ ให้กำหนด ProductMessage อินเตอร์เฟซ กำหนด ProductAction Enum สำหรับการใช้งานตัวอย่าง.
TypeScript

  • เมื่อคุณเพิ่มหรือลดผลิตภัณฑ์ คุณจะส่งข้อมูลนั้นไปยังเซิร์ฟเวอร์ในฐานะข้อความห้อง มันรวมข้อมูลเกี่ยวกับผลิตภัณฑ์ที่ต้องการเพิ่มหรือลดและจำนวนที่ต้องการเพิ่มหรือลดด้วย.
TypeScript

  • หลังจากประมวลผลการเปลี่ยนแปลงผลิตภัณฑ์ เซิร์ฟเวอร์จะส่งข้อมูลสินค้าคงคลังสุดท้ายไปยังไคลเอนต์ ซึ่งจะอัปเดต UI ตามนั้น
TypeScript




สคริปต์เซิร์ฟเวอร์

ด้านล่างนี้คือรหัสเซิร์ฟเวอร์ทั้งหมดที่จัดการสกุลเงินโลกและผลิตภัณฑ์ และวิธีการนำไปใช้

สคริปต์เซิร์ฟเวอร์ทั้งหมด

TypeScript




คำอธิบายสคริปต์เซิร์ฟเวอร์

  • จัดการสกุลเงินโลกผ่าน ZEPETO.Multiplay.Currency.
  • ใช้ currency.credit() และ currency.debit() เพื่อเพิ่มหรือลดยอดคงเหลือของสกุลเงินที่ต้องการ หลังจากนั้นให้เรียก currency.getBalances() เพื่อดูยอดคงเหลือปัจจุบันสำหรับแต่ละสกุลเงิน.
TypeScript

  • จัดการผลิตภัณฑ์ในโลกผ่าน ZEPETO.Multiplay.Inventory.
  • ใช้ inventory.add() และ inventory.use() เพื่อเพิ่มหรือลดยอดคงเหลือของสกุลเงินที่ต้องการ.
TypeScript

  • จัดการคำขอจากลูกค้าเพื่อเพิ่มหรือลดสกุลเงินและผลิตภัณฑ์.
  • ใช้ loadBalance() เพื่อดึงข้อมูลสกุลเงินที่ลงทะเบียนใน ZEPETO Studio.
  • หากมีสกุลเงินหลายสกุล คุณสามารถกำหนดเงื่อนไขตามค่า ID สกุลเงินเฉพาะเพื่อดึงยอดคงเหลือของสกุลเงินนั้นเท่านั้น.
  • ส่งค่าบัญชีสุดท้ายไปยังลูกค้าเป็นข้อความในห้อง.