คู่มือการใช้งานสำหรับการเผยแพร่สถานที่

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

ข้อจํากัด

• API นี้สนับสนุนคำขอ HTTPS เท่านั้น
• API เผยแพร่สถานที่ไม่อัปเดตประเภทตัวอย่างบางอย่างหากประสบการณ์ของคุณมี EditableImage , EditableMesh , PartOperation , SurfaceAppearance หรือ BaseWrap ตัวอย่าง, เผยแพร่จาก Studio หลังจากแก้ไขแล้ว

สถานที่บน Roblox

ประสบการณ์บน Roblox สามารถมีสถานที่หลายแห่งได้ด้วยสถานที่เริ่มต้น หนึ่งแห่ง เป็นจุดเข้าสู่ระบบของประสบการณ์ของคุณและสถานที่อื่นๆ ที่คุณสามารถ เทเลพอร์ตผู้ใช้ระหว่าง ได้คุณสามารถใช้ API เพื่อเผยแพร่สถานที่เริ่มต้นหรือสถานที่อื่นๆ ของประสบการณ์ของคุณด้วยการควบคุมรุ่น

ก่อนที่คุณจะสามารถอัปเดตสถานที่ที่มีอยู่ของประสบการณ์ได้ คุณต้องมี ID สถานที่ และ ID จักรวาล ของประสบการณ์รหัสสถานที่ ระบุสถานที่และรหัสจักรวาล ระบุประสบการณ์แต่ละอย่างมีเอกลักษณ์แม้ว่าประสบการณ์ของคุณจะมีเพียงสถานที่เดียว

เผยแพร่สถานที่

เพื่อเผยแพร่สถานที่ที่มีอยู่ของประสบการณ์ด้วย API การเผยแพร่สถานที่ :

1. สร้างคีย์ API บน แดชบอร์ดของผู้สร้าง ตรวจสอบให้แน่ใจว่าคุณดำเนินการตามการตั้งค่าต่อไปนี้:

   1. เพิ่ม สถานที่จักรวาล ใน สิทธิ์การเข้าถึง 2. เพิ่มการดำเนินการ เขียน ในประสบการณ์ที่คุณเลือก

2. รับ ID จักรวาล ของประสบการณ์ที่คุณต้องการเผยแพร่สถานที่

   1. นําทางไปยัง แดชบอร์ดผู้สร้าง
   2. ค้นหาประสบการณ์กับสถานที่ที่คุณต้องการอัปเดต
   3. เลื่อนเมาส์ไปที่ภาพรวมของประสบการณ์, คลิกปุ่ม ⋯ และเลือก คัดลอก ID ภาพขนาดย่อ

3. รับ รหัสสถานที่ ของสถานที่ที่คุณต้องการอัปเดต

   1. อยู่ในหน้า สิ่งประดิษฐ์ บน แดชบอร์ดของผู้สร้าง และคลิกภาพตัวอย่างประสบการณ์เป้าหมาย
   2. ในเมนูการนําทางด้านซ้าย, คลิกที่แท็บ สถานที่ 3. ภาพขนาดย่อ
   3. รหัสสถานที่ อยู่ใน URL ที่ส่งกลับ ตัวอย่างเช่นใน URL รหัสสถานที่ จะเป็น

4. เพิ่มคีย์ API ในหัวข้อ x-api-key ของคำขอ POST APIคำขอตัวอย่างสองต่อไปนี้อ้างอิงไฟล์สถานที่ XML ของ Roblox ( .rbxlx ) และไฟล์สถานที่ไบนารี ( .rbxl )

   คำขอไฟล์สถานที่ XML
   $ curl --verbose --location POST 'https://apis.roblox.com/universes/v1/{universeId}/places/{placeId}/versions?versionType=Published' \
   --header 'x-api-key: <your-api-key>' \
   --header 'Content-Type: application/xml' \
   --data-binary @/home/placefiles/place1.rbxlx

   คำขอไฟล์สถานที่ไบนารี
   $ curl --verbose --location POST 'https://apis.roblox.com/universes/v1/{universeId}/places/{placeId}/versions?versionType=Published' \
   --header 'x-api-key: <your-api-key>' \
   --header 'Content-Type: application/octet-stream' \
   --data-binary @/home/placefiles/place1.rbxl

   เพื่อรันคําสั่งให้แทนที่ {universeId} และ {placeId} ด้วย ID จักรวาลจริง และ รหัสสถานที่ ของประสบการณ์และสถานที่ที่คุณต้องการเผยแพร่

5. หากคุณส่งคำขออย่างถูกต้องคุณจะได้รับร่างคำตอบสําเร็จด้วยหมายเลขเวอร์ชันสถานที่ในรูปแบบต่อไปนี้:

   ตัวตอบสนองตัวอย่าง
   { "versionNumber": 7 }

6. (ตัวเลือก) ตรวจสอบการอัปโหลดใน Studio หรือบน แดชบอร์ดของผู้สร้าง