มัคคุเทศก์การใช้งานการส่งข้อความ

บริการ API ของบริการข้อความข้างเคียงของ Lua คือ Open Cloud ตัวเทียบเท่าของ Lua Class.MessagingService ซึ่งช่วยให้คุณสื่อสารระหว่างเซิร์ฟเวอร์หรือติดตั้งข

การใช้

มีเครื่องมือที่มีประโยชน์หลายอันที่คุณสามารถสร้างโดยการสนับสนุนการสื่อสารระหว่างเซิร์ฟเวอร์โดยใช้ API การส่งข้อความ

• พอร์ทัลการประกาศเว็บ : พอร์ทัลการประกาศเว็บสามารถเป็นประโยชน์ในการสนับสนุนการส่งประกาศไปยังผู้ใช้ทั้งหมดในเซิร์ฟเวอร์ในประสบการณ์ของคุณเช่นการประก

• ระบบการควบคุมจริยธรรม : ระบบการควบคุมจริยธรรมสามารถช่วยให้คุณปลอดภัยและปลอดภัยได้ เมื่อตรวจพบผู้ใช้ที่มีพฤติกรรมไม่เหมาะสม คุณสามารถเผย

• หน้าดashboard ของ LiveOps : LiveOps หน้าดashboard เป็นเครื่องมือที่มีประโยชน์สำหรับการจัดการเหตุการณ์สด เช่นปาร์ตี้ฮาโลวีน บนหน้าดashboard ของ LiveOps รหัส

ข้อจํากัด

จํากัด | คำอธิบาย --- | --- อัตรา | Roblox ปรับคำขอข้อความทุก 50 + 5 ต่อนาที, ที่ n คือจํานวนผู้เล่นใ

การตั้งหัวข้อสำหรับการส่งข้อความ

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

ในขณะนี้คุณสามารถกำหนดหัวข้อใน Studio เท่านั้นและใช้ Lua MessagingService:SubscribeAsync() เพื่อสมัครผู้ใช้ไปยังมัน ตัวอย่างโค้ดต่อไปนี้สมัครผู้ใช้ใด ๆ เมื่อพวกเขาเข้าร่วมประสบการณ์:

Set up and Subscribe Users to a Topic
local MessagingService = game:GetService("MessagingService")
local Players = game:GetService("Players")

local function onPlayerAdded(player)
	-- ระบุและสมัครรับหัวข้อ
	local topic = "YourTopic"
	local connection = MessagingService:SubscribeAsync(topic, function(message)
		print(message.Data)
	end)

	player.AncestryChanged:Connect(function()
		-- ยกเลิกการรับข้อมูลจากหัวข้อเมื่อเปลี่ยนแปลงการต้อนรับ
		connection:Disconnect()
	end)
end

Players.PlayerAdded:Connect(onPlayerAdded)

เผยแพร่ข้อความไปยังเซิร์ฟเวอร์สด

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

1. สร้างรหัส API บน หน้าผู้สร้าง แน่ใจว่าคุณปฏิบัติตามการตั้งค่าต่อไปนี้:

   1. เพิ่ม messaging-service ใน การเข้าถึงการอนุญาต 2. เพิ่ม เผยแพร่ การดำเนินการสู่ประสบการณ์ที่คุณเลือก

2. รับ รหัสจักรวาล ซึ่งเป็นรหัสของประสบการณ์ที่คุณต้องการส่งข้อความของคุณ

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

3. เพิ่มรหัส API ใน x-api-key หัวข้อของคำขอ POST ไปยัง API เช่นตัวอย่างต่อไปนี้:

   ตัวอย่างคำขอสำหรับการเผยแพร่ข้อความ
   curl \
   --location \
   --request POST \
   'https://apis.roblox.com/messaging-service/v1/universes/{universeId}/topics/{topic}' \
   -H 'x-api-key: abc...' \
   -H 'Content-Type: application/json' \
   --data-raw '{"message":"message to publish"}'

   หากคำขอของคุณประสบความสำเร็จมันจะกลับมาเป็นตัวอักษรที่ว่างเปล่า

4. เรียก API เพื่อส่งข้อความออก

เพิ่มการให้บริการจัดส่งข้อความไปยัง OAuth 2.0 แอป

คุณสามารถสร้าง แอปพลิเคชัน OAuth 2.0 ที่รองรับ Messaging Service API เพื่อให้ผู้ใช้ของคุณสามารถเผยแพร่ข้อความไปยังเซิร์ฟเวอร์ผ่านการใช้งาน OAuth 2.0 ของคุณ

เพื่อใช้ API ข้อความส่งข้อความส่งข้อความส่งข้อความส่งข้อความส่งข้อความส่งข้อความส่งข้อความส่งข้อความส่งข้อความส่งข้อความส่งข้อความส่งข้อความส่งข้อความส่งข้อความส่งข้อความส่งข้อความส่งข้อความส่งข้อความส่งข้อความส่

1. เมื่อ ลงทะเบียนให้ใช้งานแอปพลิเคชันของคุณ ภายใต้ การอนุญาต เลือกขอบเขต เผยแพร่ยูนิเวิร์ส

2. เมื่อ กําลังใช้ไหลเวียนการอนุญาต ให้รวม universe-messaging-service:publish ใน scope ตัวแปรของ URL การอนุญาตที่เปลี่ยนผู้ใช้กลับไปยังแอปพลิเคชันของคุณเช่นตัวอย่างต่อไปนี

   https://www.authorize.roblox.com?client_id=816547628409595165403873012&redirect_uri=https://my-app.com/redirect&scope=openid+universe-messaging-service:publish&response_type=Code&prompts=login+consent&nonce=12345&state=6789

3. ร้องขอการเข้าถึงไปยัง universeId ของประสบการณ์ที่ผู้ใช้ต้องการเผยแพร่ข้อความของพวกเขา รายการของ

   คำขอตัวอย่าง
   curl --location --request POST 'https://apis.roblox.com/oauth/v1/token/resources' \
   --header 'Content-Type: application/x-www-form-urlencoded' \
   --data-urlencode 'token=<access_token>' \
   --data-urlencode 'client_id=<client_id>' \
   --data-urlencode 'client_secret=<client_secret>'

   ระดับนี้กลับรายการ universeIds เช่นตัวอย่างต่อไปนี้:

   ตัวอย่างการตอบ
   {
     "resource_infos": [
       {
         "owner": {
           "id": "1516563360",
           "type": "User"
         },
         "resources": {
           "universe": {
             "ids": ["3828411582"]
           }
         }
       }
     ]
   }

4. ตอนนี้ให้คุณสามารถส่งข้อความไปยังประสบการณ์ใด ๆ ที่ผู้ใช้ได้รับอนุญาต เมื่อส่งคำขอ ให้รวมโทเค็นการเข้าถึงในหัวข้อและ universeId และหัวข้อในรายการคำขอในรูปแบบต่อไปนี้:

   คำขอตัวอย่าง
   curl --location --request POST 'https://apis.roblox.com/messaging-service/v1/universes/{universeId}/topics/{topic}' \
   --header 'Authorization: Bearer <access_token>' \
   --header 'Content-Type: application/json' \
   --data-raw '{"message":"message to publish"}'