WebSocket API
ภาพรวม¶
WebSocket API ให้บริการแชทโดยการสื่อสารกับเซิร์ฟเวอร์ Socket ผ่าน WebSocket รองรับการเชื่อมต่อของเกมไคลเอนต์ การส่งข้อความช่อง และอื่นๆ
คุณสมบัติหลักของ WebSocket API มีดังนี้
- การเชื่อมต่อ / ตัดการเชื่อมต่อของลูกค้า
- PING / PONG
- การส่ง / การรับข้อความแชท- แชทช่อง
- แชท 1:1
 
- การกรองผู้ใช้ที่ถูกบล็อก- ไม่ส่งข้อความไปยังผู้ใช้ที่ถูกบล็อก
- ไม่รับข้อความจากผู้ใช้ที่ถูกบล็อก
 
- การแจ้งเตือนการเข้าช่องและออกจากช่อง
ข้อมูลพื้นฐาน¶
นี่ให้ข้อมูลพื้นฐานที่คุณต้องรู้เมื่อใช้ WebSocket API.
คำสำคัญ¶
- ช่อง: ห้องแชท
- ข้อความช่อง: ข้อความแชทที่ส่งไปยังผู้ใช้ทั้งหมดในช่อง
- ข้อความ 1:1: ข้อความแชทที่ส่งไปยังผู้ใช้เฉพาะ
ประเภทแพ็กเกจ¶
ประเภทของแพ็กเกจสำหรับการส่งและรับกับเซิร์ฟเวอร์ซ็อกเก็ตมีดังนี้
| ชื่อแพ็กเกจ | คำอธิบาย | 
|---|---|
| CONNECT | เชื่อมต่อกับเซิร์ฟเวอร์ซ็อกเก็ต | 
| RESPONSE_CONNECT | การตอบกลับคำขอ CONNECT | 
| RECONNECT | เชื่อมต่อใหม่กับเซิร์ฟเวอร์ซ็อกเก็ต | 
| RESPONSE_RECONNECT | การตอบกลับคำขอ RECONNECT | 
| PING | รักษาการเชื่อมต่อให้มีชีวิต หากมีการขอ PING ขณะที่การเชื่อมต่อยังไม่สำเร็จ เซิร์ฟเวอร์จะตัดการเชื่อมต่อ | 
| PONG | การตอบกลับคำขอ PING | 
| CHANNEL_CHAT | แชทช่อง | 
| RESPONSE_CHANNEL_CHAT | การตอบกลับคำขอ CHANNEL_CHAT | 
| DIRECT_CHAT | แชท 1:1 | 
| RESPONSE_DIRECT_CHAT | การตอบกลับคำขอ DIRECT_CHAT | 
| NOTIFY_ENTER_CHANNEL | ข้อความการเข้าช่อง | 
| NOTIFY_EXIT_CHANNEL | ข้อความการออกจากช่อง | 
| NOTIFY_DELETE_CHANNEL | ข้อความการลบช่อง | 
| NOTIFY_CHANNEL_NOTICE | ข้อความประกาศช่อง | 
| NOTIFY_NOTICE | ข้อความประกาศผู้ใช้ | 
| NOTIFY_CHANNEL_CHAT | ข้อความแชทช่อง | 
| NOTIFY_DIRECT_CHAT | ข้อความแชท 1:1 | 
กระบวนการเชื่อมต่อซ็อกเก็ต¶
-  ขอการออกโทเค็นผ่านทาง API แชท Http จากเซิร์ฟเวอร์เกม ※ โทเค็นที่ออกจะใช้สำหรับการเชื่อมต่อกับเซิร์ฟเวอร์ Socket แชท - ขอ API การออกโทเค็นผู้ใช้ โดยใช้ Hive Certification Key
 
-  แอพไคลเอนต์ขอเชื่อมต่อกับเซิร์ฟเวอร์ Socket - การสื่อสาร WebSocket
- ใช้โทเค็นที่ออกในขั้นตอนที่ 1
- หากการเชื่อมต่อสำเร็จ เซิร์ฟเวอร์ Socket จะส่งคืนข้อมูลด้านล่าง
 
การตัดการเชื่อมต่อของซ็อกเก็ต¶
เมื่อการเชื่อมต่อ WebSocket ถูกยกเลิก เซิร์ฟเวอร์จะดำเนินการตามขั้นตอนต่อไปนี้
- ออกจากช่องทางที่เข้าร่วมและส่งข้อความแจ้งการออก
- ลบข้อมูลการเชื่อมต่อ
โครงสร้างการสื่อสารด้วยซ็อกเก็ต¶
การสื่อสาร WebSocket จะดำเนินการในรูปแบบ JSON รูปแบบแพ็กเก็ตคำขอมีดังนี้
{
        "packetType":"Packet type",
        "correlationId":"Identifier for matching the response to the request",
        "body": {
                // JSON data according to packetType
        }
}
รูปแบบแพ็กเกจการตอบกลับต่อไปนี้
{
        "packetType":"Packet type (starts with RESPONSE)",
        "correlationId":"Identifier for matching the response to the request",
        "status":"Status code",
        "message":"Status message",
        "body": // JSON Object
}
รูปแบบแพ็กเกจข้อความเซิร์ฟเวอร์ต่อไปนี้คือ
{
        "packetType":"Packet type (starts with NOTIFY)",
        "body":{
                // JSON data according to packetType
        }
}
กรณีต่อไปนี้จะมีผลเมื่อเซิร์ฟเวอร์ตัดการเชื่อมต่อ WebSocket
- หากไม่มีการร้องขอจากฝั่งลูกค้าตลอด 1 นาที
- หากไม่อยู่ในรูปแบบ JSON
- เมื่อค่าคสถานะเป็น 401 หรือ 403- 401 ไม่ได้รับอนุญาต
- 403 ห้ามเข้าถึง
 
- หากเข้าถึงจากเซสชันอื่น ให้ยุติเซสชันที่มีอยู่
รหัสการตอบกลับ¶
นี่คือรหัสสถานะการตอบกลับ
| รหัสสถานะ | ข้อความสถานะ | คำอธิบาย | 
|---|---|---|
| 200 | สำเร็จ | สำเร็จ | 
| 400 | การร้องขอที่ไม่ถูกต้อง | การร้องขอที่ไม่ถูกต้อง | 
| 401 | ไม่ได้รับอนุญาต | ไม่ได้รับอนุญาต | 
| 403 | ห้าม | ห้ามโดยเซิร์ฟเวอร์ | 
| 408 | หมดเวลาการร้องขอ | การเชื่อมต่อถูกปิดโดยเซิร์ฟเวอร์เนื่องจากไม่มีการร้องขอจากไคลเอนต์เป็นเวลา 60 วินาที | 
| 409 | ขัดแย้ง | การร้องขอของผู้ใช้ขัดแย้งกับสถานะของเซิร์ฟเวอร์ (เช่น เมื่อคู่สนทนา 1:1 ออฟไลน์) | 
| 500 | ข้อผิดพลาดของเซิร์ฟเวอร์ภายใน | ข้อผิดพลาดของเซิร์ฟเวอร์ภายใน | 
ฟีเจอร์ Websocket API¶
นี่อธิบายคำขอและการตอบสนองของ API สำหรับแต่ละฟังก์ชันของ WebSocket API ที่ใช้ในบริการแชท พร้อมกับตัวอย่างโค้ด
การเชื่อมต่อของลูกค้า¶
พารามิเตอร์คำขอ¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | 
|---|---|---|---|
| packetType | คำสั่งการเชื่อมต่อของไคลเอนต์ ( CONNECT) | สตริง | ใช่ | 
| body | ข้อมูลคำขอ | อ็อบเจ็กต์ | ใช่ | 
พารามิเตอร์การร้องขอ > เนื้อหา¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | ตัวอย่าง | 
|---|---|---|---|---|
| gameIndex | ดัชนีเกม Hive | จำนวนเต็ม | ใช่ | เช่น 1 | 
| playerId | ตัวระบุบัญชี รหัสผู้เล่น Hive | ยาว | ใช่ | เช่น 1234 | 
| langCode | รหัสภาษา Hive (ตาม ISO 639 alpha-2, ภาษาอื่นที่ไม่แยกตาม ISO 639 alpha-2 จะแยกโดยแท็ก Script) | สตริง | ใช่ | เช่น "en" | 
| loginKey | โทเค็นที่ใช้สำหรับการเข้าถึง ออกจาก Chat Http API | สตริง | ใช่ | "eyJhbGciOiJIUzI1NiJ9.eyJnYW1lSW5kZXgiOjEsInBsYXllcklkIjoxMjM0LCJpYXQiOjE3MzAzNjY4MjksImV4cCI6MTczMDM3MDQyOX0.fpg6kqwqp1QN3KuYcjVBr8j0mzjN2doefJ_D6xFxcFY" | 
เนื้อหาการตอบกลับ¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | 
|---|---|---|---|
| packetType | การตอบสนองต่อคำขอการเชื่อมต่อ ( RESPONSE_CONNECT) | สตริง | ใช่ | 
| status | รหัสสถานะ | จำนวนเต็ม | ใช่ | 
| message | ข้อความสถานะ | สตริง | ใช่ | 
| body | ข้อมูลที่ส่งกลับ | อ็อบเจ็กต์ | ใช่ | 
เนื้อหาการตอบกลับ > body¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | ตัวอย่าง | 
|---|---|---|---|---|
| sessionId | ค่าที่ส่งกลับเมื่อเชื่อมต่อสำเร็จ | สตริง | ใช่ | เช่น "005056fffea3fd10-000400fd-00000797-f67881178d98d1cd-64ae9a76" | 
ตัวอย่างคำขอ¶
{
    "packetType": "CONNECT",
    "body":{
        "gameIndex":1,
        "playerId": 1234,
        "langCode": "en",
        "loginKey": "eyJhbGciOiJIUzI1NiJ9.eyJnYW1lSW5kZXgiOjEsInBsYXllcklkIjoxMjM0LCJpYXQiOjE3MzAzNjY4MjksImV4cCI6MTczMDM3MDQyOX0.fpg6kqwqp1QN3KuYcjVBr8j0mzjN2doefJ_D6xFxcFY" // API 서버에서 생성한 JWT
    }
}
ตัวอย่างการตอบกลับ¶
{
    "packetType":"RESPONSE_CONNECT",
    "status": 200,
    "message":"OK",
    "body":{
        "sessionId":"005056fffea3fd10-000400fd-00000797-f67881178d98d1cd-64ae9a76"
    }
}
การเชื่อมต่อใหม่ของลูกค้า¶
ฟีเจอร์การเชื่อมต่อใหม่จะถูกจัดเตรียมไว้ เนื่องจากการเชื่อมต่อ WebSocket อาจถูกตัดการเชื่อมต่อขึ้นอยู่กับสถานการณ์เครือข่าย หากมีการส่งคำขอ RECONNECT ภายใน 10 นาทีหลังจากการตัดการเชื่อมต่อ WebSocket คุณจะเข้าร่วมช่องที่คุณเคยเข้าร่วมก่อนหน้านี้อีกครั้ง
พารามิเตอร์การร้องขอ¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | 
|---|---|---|---|
| packetType | คำสั่งเชื่อมต่อใหม่ของไคลเอนต์ ( RECONNECT) | สตริง | ใช่ | 
| body | ข้อมูลคำขอ | อ็อบเจ็กต์ | ใช่ | 
พารามิเตอร์คำขอ > ร่าง¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | ตัวอย่าง | 
|---|---|---|---|---|
| gameIndex | Hive ดัชนีเกม | จำนวนเต็ม | Y | เช่น 1 | 
| playerId | ตัวระบุบัญชี Hive รหัสผู้เล่น | ยาว | Y | เช่น 1234 | 
| langCode | Hive รหัสภาษา (ตาม ISO 639 alpha-2, ภาษาใด ๆ ที่ไม่แยกตาม ISO 639 alpha-2 จะถูกแยกโดยแท็ก Script) | สตริง | Y | เช่น "en" | 
| loginKey | โทเค็นที่ใช้สำหรับการเข้าถึง ออกจาก Chat Http API | สตริง | Y | "eyJhbGciOiJIUzI1NiJ9.eyJnYW1lSW5kZXgiOjEsInBsYXllcklkIjoxMjM0LCJpYXQiOjE3MzAzNjY4MjksImV4cCI6MTczMDM3MDQyOX0.fpg6kqwqp1QN3KuYcjVBr8j0mzjN2doefJ_D6xFxcFY" | 
เนื้อหาการตอบกลับ¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | 
|---|---|---|---|
| packetType | การตอบกลับต่อคำขอการเชื่อมต่อใหม่ ( RESPONSE_RECONNECT) | string | ใช่ | 
| status | รหัสสถานะ | integer | ใช่ | 
| message | ข้อความสถานะ | string | ใช่ | 
| body | ข้อมูลที่ส่งกลับ | object | ใช่ | 
เนื้อหาการตอบกลับ > body¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | ตัวอย่าง | 
|---|---|---|---|---|
| sessionId | ค่าที่ส่งกลับเมื่อเชื่อมต่อสำเร็จ | string | ใช่ | เช่น "005056fffea3fd10-000400fd-00000797-f67881178d98d1cd-64ae9a76" | 
| channelIds | รายการช่องที่เข้าร่วมสำเร็จจากช่องที่เข้าร่วมก่อนหน้านี้ | string array | ใช่ | เช่น ["ch:1", "ch:2"] | 
| failChannelIds | รายการช่องที่ไม่สามารถเข้าร่วมจากช่องที่เข้าร่วมก่อนหน้านี้ | string array | ใช่ | เช่น [] | 
ตัวอย่างคำขอ¶
{
    "packetType": "RECONNECT",
    "body":{
        "gameIndex":1,
        "playerId": 1234,
        "langCode": "en",
        "loginKey": "eyJhbGciOiJIUzI1NiJ9.eyJnYW1lSW5kZXgiOjEsInBsYXllcklkIjoxMjM0LCJpYXQiOjE3MzAzNjY4MjksImV4cCI6MTczMDM3MDQyOX0.fpg6kqwqp1QN3KuYcjVBr8j0mzjN2doefJ_D6xFxcFY" // JWT generated from the API server  
    }
}
ตัวอย่างการตอบกลับ¶
{
    "packetType":"RESPONSE_RECONNECT",
    "status": 200,
    "message":"OK",
    "body":{
        "sessionId":"005056fffea3fd10-000400fd-00000797-f67881178d98d1cd-64ae9a76",
        "channelIds":["ch:1", "ch:2"], // List of channels successfully joined from previously participated channels
        "failChannelIds":[]                // List of channels that failed to join from previously participated channels
    }
}
ปิง / ปอง¶
- คำขอจะถูกต้องเมื่อเซิร์ฟเวอร์ซ็อกเก็ตและการเชื่อมต่อเสร็จสมบูรณ์เท่านั้น
- ต้องเข้าสู่ระบบใหม่หากไม่มีการตอบกลับ PONG.
พารามิเตอร์การร้องขอ¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | 
|---|---|---|---|
| packetType | คำสั่งขอ PING ( PING) | string | Y | 
เนื้อหาการตอบกลับ¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | 
|---|---|---|---|
| packetType | คำสั่งตอบกลับ PONG ( PONG) | สตริง | Y | 
ตัวอย่างคำขอ¶
ตัวอย่างการตอบกลับ¶
การส่งข้อความช่อง¶
พารามิเตอร์การร้องขอ¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | 
|---|---|---|---|
| packetType | คำสั่งการส่งข้อความช่อง ( CHANNEL_CHAT) | สตริง | ใช่ | 
| body | ข้อมูลคำขอ | อ็อบเจ็กต์ | ใช่ | 
พารามิเตอร์การร้องขอ > เนื้อหา¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | ตัวอย่าง | 
|---|---|---|---|---|
| gameIndex | Hive ดัชนีเกม | integer | Y | e.g. 1 | 
| from | ตัวระบุของบัญชีที่จะส่งข้อความไปยังช่อง Hive player ID | long | Y | e.g. 1234 | 
| to | ช่อง ID ที่จะส่งข้อความไปยังช่อง Chat Http API ที่สร้างขึ้น | string | Y | e.g. "open:1" | 
| message | ข้อความที่จะส่งไปยังช่อง (สูงสุด 200 ตัวอักษร) | string | Y | e.g. "Hello World!" | 
| extraData | ข้อมูลเพิ่มเติมสำหรับข้อความ ( UTF-8based)(สูงสุด 256 ไบต์) | string | Y | e.g. "bbbb" | 
| langCode | รหัสภาษาของข้อความที่ส่ง Hive รหัสภาษา (ตาม ISO 639 alpha-2, ภาษาใด ๆ ที่ไม่แยกแยะโดย ISO 639 alpha-2 ควรแยกด้วยแท็ก Script) | string | Y | e.g. "en" | 
เนื้อหาการตอบกลับ¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | 
|---|---|---|---|
| packetType | การตอบสนองต่อการส่งข้อความช่อง ( RESPONSE_CHANNEL_CHAT) | สตริง | ใช่ | 
| status | รหัสสถานะ | จำนวนเต็ม | ใช่ | 
| message | ข้อความสถานะ | สตริง | ใช่ | 
ตัวอย่างคำขอ¶
{
    "packetType":"CHANNEL_CHAT",
    "body": {
        "gameIndex": 1,
        "from": 1234,
        "to": "open:1",
        "message": "Hello World!",
        "extraData": "bbbb",
        "langCode": "en"
    }
}
ตัวอย่างการตอบกลับ¶
การส่งข้อความ 1:1¶
พารามิเตอร์การร้องขอ¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | 
|---|---|---|---|
| packetType | คำสั่งการส่งข้อความ 1:1 ( DIRECT_CHAT) | สตริง | ใช่ | 
| body | ข้อมูลการร้องขอ | อ็อบเจ็กต์ | ใช่ | 
พารามิเตอร์การร้องขอ > เนื้อหา¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | ตัวอย่าง | 
|---|---|---|---|---|
| gameIndex | Hive ดัชนีเกม | integer | Y | เช่น 1 | 
| from | ตัวระบุบัญชีผู้ส่งข้อความ 1:1 Hive รหัสผู้เล่น | long | Y | เช่น 1234 | 
| to | ตัวระบุบัญชีผู้รับข้อความ 1:1 Hive รหัสผู้เล่น | long | Y | เช่น 2222 | 
| message | ข้อความที่จะส่ง 1:1 (สูงสุด 200 ตัวอักษร) | string | Y | เช่น "สวัสดีชาวโลก!" | 
| extraData | ข้อมูลเพิ่มเติมเกี่ยวกับข้อความ ( UTF-8based)(สูงสุด 256 ไบต์) | string | Y | เช่น "bbbb" | 
| langCode | รหัสภาษาของข้อความที่ส่ง Hive รหัสภาษา (ตาม ISO 639 alpha-2, ภาษาใดที่ไม่แยกตาม ISO 639 alpha-2 ควรแยกด้วยแท็ก Script) | string | Y | เช่น "th" | 
เนื้อหาการตอบกลับ¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | 
|---|---|---|---|
| packetType | การตอบสนองต่อการส่งข้อความ 1:1 ( RESPONSE_DIRECT_CHAT) | สตริง | ใช่ | 
| status | รหัสสถานะ | จำนวนเต็ม | ใช่ | 
| message | ข้อความสถานะ | สตริง | ใช่ | 
เนื้อหาการตอบกลับ > body¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | ตัวอย่าง | 
|---|---|---|---|---|
| status | รหัสสถานะการตอบกลับ | จำนวนเต็ม | Y | เช่น 200 | 
ตัวอย่างคำขอ¶
{
  "packetType": "DIRECT_CHAT",
  "body": {
    "gameIndex": 1,
    "from": 2222,
    "to": 1234,
    "message": "안녕하세요",
    "extraData": "bbbb",
    "langCode": "ko"
  }
}
ตัวอย่างการตอบกลับ¶
ข้อความเหตุการณ์เซิร์ฟเวอร์ซ็อกเก็ต¶
นี่อธิบายข้อความที่ส่งจากเซิร์ฟเวอร์ไปยังไคลเอนต์เมื่อเกิดเหตุการณ์ขึ้น
ข้อความนี้เริ่มต้นด้วย packetType NOTIFY。
ข้อความเข้าช่อง¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | 
|---|---|---|---|
| packetType | ข้อความเข้าสู่ช่อง ( NOTIFY_ENTER_CHANNEL) | สตริง | ใช่ | 
| body | ข้อมูลคำขอ | อ็อบเจ็กต์ | ใช่ | 
เนื้อหา¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | ตัวอย่าง | 
|---|---|---|---|---|
| gameIndex | Hive ดัชนีเกม | จำนวนเต็ม | ใช่ | เช่น 1 | 
| channelId | รหัสช่องที่ป้อน | สตริง | ใช่ | เช่น "open:10" | 
| playerId | ตัวระบุสำหรับบัญชีที่เข้าช่อง Hive รหัสผู้เล่น | ยาว | ใช่ | เช่น 1234 | 
| timestamp | วันที่และเวลาที่เข้าช่อง (ตาม UTC+0, รูปแบบyyyy-MM-dd'T'HH:mm:ss.SSSZ) | สตริง | ใช่ | เช่น "2024-11-12T08:59:59.497Z" | 
| timestampMillis | วันที่และเวลาที่เข้าช่อง (Unix Timestamp Millisecond) | ยาว | ใช่ | เช่น 1731401989 | 
ตัวอย่าง¶
{
  "packetType": "NOTIFY_ENTER_CHANNEL",
  "body": {
    "gameIndex": 1,
    "channelId": "open:10",
    "playerId": 1234,
    "timestamp": "2024-11-12T08:59:59.497Z",
    "timestampMillis": 1731401989
  }
}
ข้อความออกจากช่อง¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | 
|---|---|---|---|
| packetType | ข้อความออกจากช่อง ( NOTIFY_EXIT_CHANNEL) | สตริง | ใช่ | 
| body | ข้อมูลการร้องขอ | อ็อบเจ็กต์ | ใช่ | 
เนื้อหา¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | ตัวอย่าง | 
|---|---|---|---|---|
| gameIndex | Hive ดัชนีเกม | integer | ใช่ | เช่น 1 | 
| channelId | ID ของช่องที่ออก | string | ใช่ | เช่น "open:10" | 
| playerId | ตัวระบุของบัญชีที่ออกจากช่อง Hive ID ผู้เล่น | long | ใช่ | เช่น 2222 | 
| timestamp | วันที่และเวลาที่ออกจากช่อง ( มาตรฐาน UTC+0รูปแบบyyyy-MM-dd'T'HH:mm:ss.SSSZ) | string | ใช่ | เช่น "2024-11-12T08:59:59.497Z" | 
| timestampMillis | วันที่และเวลาที่ออกจากช่อง (UnixTimestamp Millisecond) | long | ใช่ | เช่น 1731401989 | 
ตัวอย่าง¶
{
  "packetType": "NOTIFY_EXIT_CHANNEL",
  "body": {
    "gameIndex": 1,
    "channelId": "open:10",
    "playerId": 2222,
    "timestamp": "2024-11-12T09:29:35.872Z",
    "timestampMillis": 1731401989
  }
}
ข้อความการลบช่อง¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | 
|---|---|---|---|
| packetType | ข้อความการลบช่อง ( NOTIFY_DELETE_CHANNEL) | string | ใช่ | 
| body | ข้อมูลคำขอ | object | ใช่ | 
ร่างกาย¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | ตัวอย่าง | 
|---|---|---|---|---|
| gameIndex | Hive ดัชนีเกม | integer | Y | เช่น 1 | 
| channelId | ID ช่องที่ถูกลบ | string | Y | เช่น "open:10" | 
| timestamp | วันที่และเวลาที่ช่องถูกลบ (ตาม UTC+0, รูปแบบyyyy-MM-dd'T'HH:mm:ss.SSSZ) | string | Y | เช่น "2024-11-12T08:59:59.497Z" | 
| timestampMillis | วันที่และเวลาที่ช่องถูกลบ (UnixTimestamp Millisecond) | long | Y | เช่น 1731401989 | 
ตัวอย่าง¶
{
  "packetType": "NOTIFY_DELETE_CHANNEL",
  "body": {
    "gameIndex": 1,
    "channelId": "owner:1",
    "timestamp": "2024-11-13T05:06:29.198Z",
    "timestampMillis": 1731401989
  }
}
ข้อความประกาศช่อง¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | 
|---|---|---|---|
| packetType | ข้อความการแจ้งเตือน ( NOTIFY_CHANNEL_NOTICE) | สตริง | ใช่ | 
| body | ข้อมูลคำขอ | อ็อบเจ็กต์ | ใช่ | 
เนื้อหา¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | ตัวอย่าง | 
|---|---|---|---|---|
| gameIndex | Hive ดัชนีเกม | integer | Y | เช่น 1 | 
| channelId | รหัสช่องที่ได้รับข้อความการแจ้งเตือน | string | Y | เช่น "open:10" | 
| from | ตัวระบุของบัญชีที่ส่งข้อความการแจ้งเตือน | string | Y | เช่น SYSTEM | 
| message | เนื้อหาของข้อความการแจ้งเตือน | string | Y | เช่น "นี่คือข้อความการแจ้งเตือน." | 
| timestamp | วันที่และเวลาที่ส่งข้อความการแจ้งเตือน (ตาม UTC+0, รูปแบบyyyy-MM-dd'T'HH:mm:ss.SSSZ) | string | Y | เช่น "2024-11-13T05:06:29.198Z" | 
| timestampMillis | วันที่และเวลาที่ส่งข้อความการแจ้งเตือน (UnixTimestamp Millisecond) | long | Y | เช่น 1731401989 | 
ตัวอย่าง¶
// 특정 채널에 공지
{
  "packetType": "NOTIFY_CHANNEL_NOTICE",
  "body": {
    "gameIndex": 1,
    "channelId": "open:10",
    "from": "SYSTEM",
    "message": "공지 메시지 입니다.",
    "timestamp": "2024-11-13T05:06:29.198Z",
    "timestampMillis": 1731401989
  }
}
ข้อความแจ้งเตือนผู้ใช้¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | 
|---|---|---|---|
| packetType | ข้อความการแจ้งเตือนของผู้ใช้ ( NOTIFY_NOTICE) | สตริง | ใช่ | 
| body | ข้อมูลการร้องขอ | ออบเจ็กต์ | ใช่ | 
เนื้อหา¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | ตัวอย่าง | 
|---|---|---|---|---|
| gameIndex | Hive ดัชนีเกม | จำนวนเต็ม | ใช่ | เช่น 1 | 
| playerId | รหัสผู้เล่นที่ได้รับข้อความแจ้งเตือน | ยาว | ใช่ | เช่น 123123 | 
| from | ตัวระบุของบัญชีที่ส่งข้อความแจ้งเตือน | สตริง | ใช่ | เช่น SYSTEM | 
| message | เนื้อหาของข้อความแจ้งเตือน | สตริง | ใช่ | เช่น "นี่คือข้อความแจ้งเตือน" | 
| timestamp | วันที่และเวลาที่ส่งข้อความแจ้งเตือน (ตาม UTC+0, รูปแบบyyyy-MM-dd'T'HH:mm:ss.SSSZ) | สตริง | ใช่ | เช่น "2024-11-13T05:06:29.198Z" | 
| timestampMillis | วันที่และเวลาที่ส่งข้อความแจ้งเตือน (UnixTimestamp มิลลิวินาที) | ยาว | ใช่ | เช่น 1731401989 | 
ตัวอย่าง¶
// Notice message for a specific user
{
  "packetType": "NOTIFY_NOTICE",
  "body": {
    "gameIndex": 1,
    "playerId": 123123,
    "from": "SYSTEM",
    "message": "공지 메시지 입니다.",
    "timestamp": "2024-11-13T05:06:29.198Z",
    "timestampMillis": 1731401989
  }
}
ข้อความช่อง¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | 
|---|---|---|---|
| packetType | ข้อความช่องทาง ( NOTIFY_CHANNEL_CHAT) | สตริง | ใช่ | 
| body | ข้อมูลคำขอ | วัตถุ | ใช่ | 
เนื้อหา¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | ตัวอย่าง | 
|---|---|---|---|---|
| gameIndex | ดัชนีเกม Hive | จำนวนเต็ม | ใช่ | เช่น 1 | 
| from | รหัสประจำตัวของบัญชีที่ส่งข้อความช่อง รหัสผู้เล่น Hive | ยาว | ใช่ | เช่น 2222 | 
| to | รหัสช่องที่ส่งข้อความช่อง | สตริง | ใช่ | เช่น "open:10" | 
| message | เนื้อหาของข้อความช่อง | สตริง | ใช่ | เช่น "สวัสดี นี่คือการสนทนาช่อง" | 
| extraData | ข้อมูลเพิ่มเติมของข้อความ ( UTF-8based)(สูงสุด 256 ไบต์) | สตริง | ใช่ | เช่น "bbbb" | 
| timestamp | วันที่และเวลาของข้อความช่องที่ส่ง ( UTC+0based, รูปแบบyyyy-MM-dd'T'HH:mm:ss.SSSZ) | สตริง | ใช่ | เช่น "2024-11-13T05:12:18.385Z" | 
| timestampMillis | วันที่และเวลาของข้อความช่องที่ส่ง (UnixTimestamp มิลลิวินาที) | ยาว | ใช่ | เช่น 1731401989 | 
ตัวอย่าง¶
{
  "packetType": "NOTIFY_CHANNEL_CHAT",
  "body": {
    "gameIndex": 1,
    "from": 2222,
    "to": "open:10",
    "message": "Hello World!",
    "extraData": "bbbb",
    "timestamp": "2024-11-13T05:12:18.385Z",
    "timestampMillis": 1731401989
  }
}
1:1 ข้อความ¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | 
|---|---|---|---|
| packetType | 1:1 ข้อความ ( NOTIFY_DIRECT_CHAT) | string | Y | 
| body | ข้อมูลการร้องขอ | object | Y | 
เนื้อหา¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | ตัวอย่าง | 
|---|---|---|---|---|
| gameIndex | ดัชนีเกม Hive | จำนวนเต็ม | ใช่ | เช่น 1 | 
| from | ตัวระบุบัญชีผู้ส่งข้อความ 1:1 Hive player ID | ยาว | ใช่ | เช่น 1234 | 
| to | ตัวระบุบัญชีผู้รับข้อความ 1:1 Hive player ID | ยาว | ใช่ | เช่น 2222 | 
| message | เนื้อหาข้อความ 1:1 | สตริง | ใช่ | เช่น "สวัสดี นี่คือการสนทนา 1:1" | 
| extraData | ข้อมูลเพิ่มเติมเกี่ยวกับข้อความ ( UTF-8based)(สูงสุด 256 ไบต์) | สตริง | ใช่ | เช่น "abcd" | 
| timestamp | วันที่และเวลาที่ส่งข้อความ 1:1 ( UTC+0based, รูปแบบyyyy-MM-dd'T'HH:mm:ss.SSSZ) | สตริง | ใช่ | เช่น "2024-11-13T05:12:50.060Z" | 
| timestampMillis | วันที่และเวลาที่ส่งข้อความ 1:1 (UnixTimestamp Millisecond) | ยาว | ใช่ | เช่น 1731401989 |