---
title: ZEPETO.Module.Social
slug: world-sdk-guide-th/zepetomodulesocial
docTags: 
createdAt: 2026-09-04T05:12:01.698Z
---

| ประเภท                                                      | คำอธิบาย                                                                                                                                                                                           |
| ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [SocialService](./#socialservice)                           | `SocialService` ใช้งานฟังก์ชันทางสังคมภายใน ZEPETO World บริการนี้ช่วยให้ผู้เล่นเข้าถึงข้อมูลทางสังคม เช่น ความสัมพันธ์การติดตามของผู้ใช้ และยังมีความสามารถในการส่งข้อความส่วนตัวถึงผู้เล่นคนอื่น |
| [RoomMemberStatus](./#roommemberstatus)                     | Enum ที่แสดงความสัมพันธ์กับ local player                                                                                                                                                           |
| [MyFollowerListResponse](./#myfollowerlistresponse)         | คลาส `MyFollowerListResponse` ให้ข้อมูลรายชื่อผู้ติดตามของ local player                                                                                                                            |
| [MyFollowingListResponse](./#myfollowinglistresponse)       | คลาส `MyFollowingListResponse` ให้ผลลัพธ์การเรียก API และข้อมูลรายชื่อที่ local player ติดตามอยู่                                                                                                  |
| [UserFollowInfoListResponse](./#userfollowinfolistresponse) | คลาส `UserFollowInfoListResponse` ให้ผลลัพธ์การเรียก API และรายการข้อมูลการติดตามของผู้ใช้หลายคน                                                                                                   |
| [UserFollowInfoResponse](./#userfollowinforesponse)         | คลาส `UserFollowInfoResponse` ให้ผลลัพธ์การเรียก API และรายการข้อมูลการติดตามของผู้ใช้                                                                                                             |
| [UserFollowStatusResponse](./#userfollowstatusresponse)     | คลาส `UserFollowStatusResponse` ให้ผลลัพธ์การเรียก API และข้อมูลที่ระบุว่าผู้ใช้ที่กำหนดมีความสัมพันธ์การติดตามกับ local player หรือไม่                                                            |
| [DirectMessagePopupState](./#directmessagepopupstate)       | แจกแจงสถานะของป๊อปอัปข้อความส่วนตัว                                                                                                                                                                |
| [UserInfo](./#userinfo)                                     | ข้อมูลผู้ใช้                                                                                                                                                                                       |
| [UserFollowInfo](./#userfollowinfo)                         | ข้อมูลการติดตามของผู้ใช้                                                                                                                                                                           |
| [UserAccountType](./#useraccounttype)                       | Enum ที่แสดงประเภทบัญชีผู้ใช้                                                                                                                                                                      |
| [FollowStatus](./#followstatus)                             | แสดงความสัมพันธ์การติดตามกับ local player                                                                                                                                                          |
| [FollowCellView](./#followcellview)                         | คลาสสำหรับป๊อปอัปรายชื่อเพื่อนอย่างเป็นทางการ                                                                                                                                                      |
| [UserInfoCellView](./#userinfocellview)                     | คลาสสำหรับองค์ประกอบ UI ที่แสดงข้อมูลเพื่อนในป๊อปอัปรายชื่อเพื่อนอย่างเป็นทางการ                                                                                                                   |
| [TotalCountCellView](./#totalcountcellview)                 | คลาสสำหรับแสดงจำนวนเพื่อนทั้งหมดในป๊อปอัปรายชื่อเพื่อนอย่างเป็นทางการ                                                                                                                              |

## SocialService

`class`

`SocialService` ใช้งานฟังก์ชันทางสังคมภายใน ZEPETO World
บริการนี้ช่วยให้ผู้เล่นเข้าถึงข้อมูลทางสังคม เช่น ความสัมพันธ์การติดตามของผู้ใช้
และยังมีความสามารถในการส่งข้อความส่วนตัวถึงผู้เล่นคนอื่น

### เมธอด

### add\_onRoomMemberStatusChanged

`static add_onRoomMemberStatusChanged(value: Action<string, RoomMemberStatus>) → void`

เมธอดแบบอะซิงโครนัสนี้ใช้ดึงรายชื่อผู้ติดตามของ local player

| พารามิเตอร์ | ประเภท                             |
| ----------- | ---------------------------------- |
| value       | `Action<string, RoomMemberStatus>` |

### GetMyFollowingListAsync

`static GetMyFollowingListAsync(nextPageToken?: string) → BaseRequest<MyFollowingListResponse>`

เมธอดแบบอะซิงโครนัสนี้ใช้ดึงรายชื่อที่ local player ติดตามอยู่

| พารามิเตอร์               | ประเภท   | คำอธิบาย                                                                      |
| ------------------------- | -------- | ----------------------------------------------------------------------------- |
| nextPageToken (ไม่บังคับ) | `string` | โทเคนของหน้า เมื่อเรียกเมธอดนี้เป็นครั้งแรก ให้กำหนดพารามิเตอร์นี้เป็น `null` |

**ค่าที่คืนกลับ:** `BaseRequest<MyFollowingListResponse>` — อ็อบเจกต์ `BaseRequest` เมื่อกระบวนการแบบอะซิงโครนัสเสร็จสิ้น คุณจะสามารถเข้าถึงอ็อบเจกต์ `MyFollowingListResponse` ได้ผ่านพร็อพเพอร์ตี้ `responseData`

### GetUserFollowInfoAsync

`static GetUserFollowInfoAsync(userIds: string[]) → BaseRequest<UserFollowInfoListResponse>`

เมธอดแบบอะซิงโครนัสนี้ใช้ดึงข้อมูลการติดตามจากผู้ใช้หลายคน

| พารามิเตอร์ | ประเภท     | คำอธิบาย                                      |
| ----------- | ---------- | --------------------------------------------- |
| userIds     | `string[]` | ID ของผู้ใช้หลายคนที่ต้องการค้นหารายการติดตาม |

**ค่าที่คืนกลับ:** `BaseRequest<UserFollowInfoListResponse>` — อ็อบเจกต์ `BaseRequest` เมื่อกระบวนการแบบอะซิงโครนัสเสร็จสิ้น คุณจะสามารถเข้าถึงอ็อบเจกต์ `UserFollowInfoListResponse` ได้ผ่านพร็อพเพอร์ตี้ `responseData`

### GetUserFollowInfoAsync

`static GetUserFollowInfoAsync(userId: string) → BaseRequest<UserFollowInfoResponse>`

เมธอดแบบอะซิงโครนัสนี้ใช้ดึงข้อมูลการติดตามจากผู้ใช้รายหนึ่ง

| พารามิเตอร์ | ประเภท   | คำอธิบาย                                |
| ----------- | -------- | --------------------------------------- |
| userId      | `string` | ID ของผู้ใช้ที่ต้องการค้นหารายการติดตาม |

**ค่าที่คืนกลับ:** `BaseRequest<UserFollowInfoResponse>` — อ็อบเจกต์ `BaseRequest` เมื่อกระบวนการแบบอะซิงโครนัสเสร็จสิ้น คุณจะสามารถเข้าถึงอ็อบเจกต์ `UserFollowInfoResponse` ได้ผ่านพร็อพเพอร์ตี้ `responseData`

### GetUserFollowStatusAsync

`static GetUserFollowStatusAsync(userId: string) → BaseRequest<UserFollowStatusResponse>`

เมธอดแบบอะซิงโครนัสนี้ใช้ดึงข้อมูลความสัมพันธ์การติดตามระหว่าง local player กับผู้ใช้รายหนึ่ง

| พารามิเตอร์ | ประเภท   | คำอธิบาย                                  |
| ----------- | -------- | ----------------------------------------- |
| userId      | `string` | ID ของผู้ใช้ที่ต้องการค้นหาสถานะการติดตาม |

**ค่าที่คืนกลับ:** `BaseRequest<UserFollowStatusResponse>` — อ็อบเจกต์ `BaseRequest` เมื่อกระบวนการแบบอะซิงโครนัสเสร็จสิ้น คุณจะสามารถเข้าถึงอ็อบเจกต์ `UserFollowStatusResponse` ได้ผ่านพร็อพเพอร์ตี้ `responseData`

### OpenPopupDirectMessage

`static OpenPopupDirectMessage(sendMessage: string, userIds?: string[], onComplete?: Action<DirectMessagePopupState>) → void`

เรียกป๊อปอัปสำหรับส่งข้อความส่วนตัวถึงผู้ใช้

| พารามิเตอร์            | ประเภท                            | คำอธิบาย                                                                                                                                                |
| ---------------------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| sendMessage            | `string`                          | เนื้อหาของข้อความที่จะส่ง หากเว้นว่างหรือไม่มีข้อความ การส่งจะล้มเหลว                                                                                   |
| userIds (ไม่บังคับ)    | `string[]`                        | รายการ ID ของผู้ใช้ที่อาจเป็นผู้รับ หากละพารามิเตอร์ `users` ไว้ หน้าจอเลือกผู้รับจะถูกเติมด้วยผู้ใช้จากรายชื่อผู้ติดตาม/ที่ติดตามของผู้ส่งโดยอัตโนมัติ |
| onComplete (ไม่บังคับ) | `Action<DirectMessagePopupState>` | ฟังก์ชัน callback ที่จะถูกเรียกเมื่อการส่งข้อความเสร็จสิ้นหรือถูกยกเลิก                                                                                 |

## RoomMemberStatus

`enum`

Enum ที่แสดงความสัมพันธ์กับ local player

| ชื่อ      | ค่า | คำอธิบาย                                             |
| --------- | --- | ---------------------------------------------------- |
| None      | 0   | ระบุว่า local player ไม่ได้ติดตามผู้ใช้รายนี้หรือไม่ |
| Following | 1   | ระบุว่า local player ติดตามผู้ใช้รายนี้หรือไม่       |
| Blocked   | 3   | ระบุว่า local player บล็อกผู้ใช้รายนี้หรือไม่        |

## MyFollowerListResponse

`class` · extends `PlayBaasResponse`

คลาส `MyFollowerListResponse` ให้ข้อมูลรายชื่อผู้ติดตามของ local player

### พร็อพเพอร์ตี้

| ชื่อ          | ประเภท                      | คำอธิบาย                                                                                                                                                       |
| ------------- | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| userCount     | `number`                    | จำนวนผู้ใช้ที่ติดตาม local player                                                                                                                              |
| users         | [UserInfo\[\]](./#userinfo) | ข้อมูลของผู้ใช้ที่ติดตาม local player                                                                                                                          |
| nextPageToken | `string`                    | เมื่อมีรายการจำนวนมาก `nextPageToken` จะรวมอยู่ในการตอบกลับ ทำให้สามารถดึงรายชื่อผู้ติดตามชุดถัดไปได้ หากไม่มีรายการเหลืออยู่ `nextPageToken` จะมีค่าเป็น null |

## MyFollowingListResponse

`class` · extends `PlayBaasResponse`

คลาส `MyFollowingListResponse` ให้ผลลัพธ์การเรียก API และข้อมูลรายชื่อที่ local player ติดตามอยู่

### พร็อพเพอร์ตี้

| ชื่อ          | ประเภท                      | คำอธิบาย                                                                                                                                                       |
| ------------- | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| userCount     | `number`                    | จำนวนผู้ใช้ที่ local player ติดตามอยู่                                                                                                                         |
| users         | [UserInfo\[\]](./#userinfo) | ข้อมูลของผู้ใช้ที่ local player ติดตามอยู่                                                                                                                     |
| bookMarkUsers | [UserInfo\[\]](./#userinfo) | ข้อมูลของผู้ใช้ที่ local player บุ๊กมาร์กไว้                                                                                                                   |
| nextPageToken | `string`                    | เมื่อมีรายการจำนวนมาก `nextPageToken` จะรวมอยู่ในการตอบกลับ ทำให้สามารถดึงรายชื่อที่ติดตามชุดถัดไปได้ หากไม่มีรายการเหลืออยู่ `nextPageToken` จะมีค่าเป็น null |

## UserFollowInfoListResponse

`class` · extends `BaseResponse`

คลาส `UserFollowInfoListResponse` ให้ผลลัพธ์การเรียก API และรายการข้อมูลการติดตามของผู้ใช้หลายคน

### พร็อพเพอร์ตี้

| ชื่อ  | ประเภท                                  | คำอธิบาย                                        |
| ----- | --------------------------------------- | ----------------------------------------------- |
| users | [UserFollowInfo\[\]](./#userfollowinfo) | อาร์เรย์ของรายการข้อมูลการติดตามของผู้ใช้หลายคน |

## UserFollowInfoResponse

`class` · extends `BaseResponse`

คลาส `UserFollowInfoResponse` ให้ผลลัพธ์การเรียก API และรายการข้อมูลการติดตามของผู้ใช้

### พร็อพเพอร์ตี้

| ชื่อ | ประเภท                              | คำอธิบาย                                  |
| ---- | ----------------------------------- | ----------------------------------------- |
| user | [UserFollowInfo](./#userfollowinfo) | อาร์เรย์ของรายการข้อมูลการติดตามของผู้ใช้ |

## UserFollowStatusResponse

`class` · extends `PlayBaasResponse`

คลาส `UserFollowStatusResponse` ให้ผลลัพธ์การเรียก API และข้อมูลที่ระบุว่าผู้ใช้ที่กำหนดมีความสัมพันธ์การติดตามกับ local player หรือไม่

### พร็อพเพอร์ตี้

| ชื่อ   | ประเภท                          | คำอธิบาย                                                   |
| ------ | ------------------------------- | ---------------------------------------------------------- |
| status | [FollowStatus](./#followstatus) | ความสัมพันธ์การติดตามระหว่างผู้ใช้ที่กำหนดกับ local player |

## DirectMessagePopupState

`enum`

แจกแจงสถานะของป๊อปอัปข้อความส่วนตัว

| ชื่อ         | ค่า | คำอธิบาย                                     |
| ------------ | --- | -------------------------------------------- |
| Cancel       | 0   | เมื่อป๊อปอัปถูกปิดด้วยตนเองหรือการส่งล้มเหลว |
| SendComplete | 1   | เมื่อคำขอส่งเสร็จสมบูรณ์และป๊อปอัปปิดลง      |

## UserInfo

`class`

ข้อมูลผู้ใช้

### พร็อพเพอร์ตี้

| ชื่อ              | ประเภท                                | คำอธิบาย                                                  |
| ----------------- | ------------------------------------- | --------------------------------------------------------- |
| zepetoId          | `string`                              | แฮนเดิลเฉพาะของผู้ใช้ ซึ่งโดยทั่วไปแสดงพร้อมสัญลักษณ์ `@` |
| userId            | `string`                              | ตัวระบุผู้ใช้ภายในระบบ                                    |
| name              | `string`                              | ชื่อที่แสดงของผู้ใช้                                      |
| isOfficialAccount | `boolean`                             | ระบุว่าบัญชีนี้เป็นบัญชีทางการหรือไม่                     |
| accountType       | [UserAccountType](./#useraccounttype) | ประเภทบัญชีผู้ใช้                                         |
| followStatus      | [FollowStatus](./#followstatus)       | ความสัมพันธ์การติดตามกับ local player                     |

### เมธอด

### GetProfileThumbnailAsync

`GetProfileThumbnailAsync() → BaseRequest<TextureResponse>`

เมธอดแบบอะซิงโครนัสนี้ใช้ดึงภาพขนาดย่อของโปรไฟล์ผู้ใช้

**ค่าที่คืนกลับ:** `BaseRequest<TextureResponse>` — อ็อบเจกต์ `BaseRequest` เมื่อกระบวนการแบบอะซิงโครนัสเสร็จสิ้น คุณจะสามารถเข้าถึงอ็อบเจกต์ `TextureResponse` ได้ผ่านพร็อพเพอร์ตี้ `responseData`

### GetBadgeImageAsync

`GetBadgeImageAsync() → BaseRequest<TextureResponse>`

เมธอดแบบอะซิงโครนัสนี้ใช้ดึงภาพแบดจ์จากโปรไฟล์ของผู้ใช้ หากผู้ใช้เป็นบัญชี Greeter หรือ Creator

**ค่าที่คืนกลับ:** `BaseRequest<TextureResponse>` — อ็อบเจกต์ `BaseRequest` เมื่อกระบวนการแบบอะซิงโครนัสเสร็จสิ้น คุณจะสามารถเข้าถึงอ็อบเจกต์ `TextureResponse` ได้ผ่านพร็อพเพอร์ตี้ `responseData`

## UserFollowInfo

`class` · extends [UserInfo](./#userinfo)

ข้อมูลการติดตามของผู้ใช้

### พร็อพเพอร์ตี้

| ชื่อ           | ประเภท   | คำอธิบาย                         |
| -------------- | -------- | -------------------------------- |
| followingCount | `number` | จำนวนผู้ใช้ที่บัญชีนี้ติดตามอยู่ |
| followerCount  | `number` | จำนวนผู้ติดตามของบัญชีนี้        |

## UserAccountType

`enum`

Enum ที่แสดงประเภทบัญชีผู้ใช้

| ชื่อ    | ค่า | คำอธิบาย                                                                   |
| ------- | --- | -------------------------------------------------------------------------- |
| Default | 0   | ผู้ใช้ทั่วไป                                                               |
| Greeter | 1   | บัญชีที่กำหนดไว้สำหรับโปรแกรม Greeter ซึ่งออกแบบมาเพื่อช่วยเหลือผู้ใช้ใหม่ |

## FollowStatus

`class`

แสดงความสัมพันธ์การติดตามกับ local player

### พร็อพเพอร์ตี้

| ชื่อ        | ประเภท    | คำอธิบาย                                           |
| ----------- | --------- | -------------------------------------------------- |
| isFollower  | `boolean` | ระบุว่าผู้ใช้เป็นผู้ติดตามของ local player หรือไม่ |
| isFollowing | `boolean` | ระบุว่า local player ติดตามผู้ใช้รายนี้หรือไม่     |

## FollowCellView

`class` · extends `EnhancedScrollerCellView`

คลาสสำหรับป๊อปอัปรายชื่อเพื่อนอย่างเป็นทางการ

### พร็อพเพอร์ตี้

| ชื่อ                | ประเภท   | คำอธิบาย                                                                                                                                                     |
| ------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| textFollowButton    | `string` | คืนค่าป้ายข้อความที่แปลแล้วซึ่งจะแสดงบนปุ่ม Follow ในป๊อปอัปรายชื่อเพื่อนอย่างเป็นทางการ ข้อความจะถูกแปลเป็นภาษาที่ตรงกับการตั้งค่าของอุปกรณ์โดยอัตโนมัติ    |
| textFollowingButton | `string` | คืนค่าป้ายข้อความที่แปลแล้วซึ่งจะแสดงบนปุ่ม Following ในป๊อปอัปรายชื่อเพื่อนอย่างเป็นทางการ ข้อความจะถูกแปลเป็นภาษาที่ตรงกับการตั้งค่าของอุปกรณ์โดยอัตโนมัติ |
| cellHeight          | `number` | คืนค่าความสูงของ cell view ข้อมูลผู้ใช้                                                                                                                      |

### อีเวนต์

| ชื่อ          | ประเภท       | คำอธิบาย                                                                      |
| ------------- | ------------ | ----------------------------------------------------------------------------- |
| onCreated     | `UnityEvent` | คืนค่าอีเวนต์ที่ถูกเรียกเมื่อป๊อปอัปรายชื่อเพื่อนอย่างเป็นทางการถูกสร้างขึ้น  |
| onDeactivated | `UnityEvent` | คืนค่าอีเวนต์ที่ถูกเรียกเมื่อป๊อปอัปรายชื่อเพื่อนอย่างเป็นทางการถูกปิดใช้งาน  |
| onActivated   | `UnityEvent` | คืนค่าอีเวนต์ที่ถูกเรียกเมื่อป๊อปอัปรายชื่อเพื่อนอย่างเป็นทางการถูกเปิดใช้งาน |

## UserInfoCellView

`class` · extends [FollowCellView](./#followcellview)

คลาสสำหรับองค์ประกอบ UI ที่แสดงข้อมูลเพื่อนในป๊อปอัปรายชื่อเพื่อนอย่างเป็นทางการ

### พร็อพเพอร์ตี้

| ชื่อ     | ประเภท                  | คำอธิบาย                             |
| -------- | ----------------------- | ------------------------------------ |
| userInfo | [UserInfo](./#userinfo) | คืนค่าข้อมูลผู้ใช้ที่แสดงบน UI       |
| textName | `string`                | คืนค่าชื่อผู้ใช้ของบัญชีที่แสดงบน UI |

## TotalCountCellView

`class` · extends [FollowCellView](./#followcellview)

คลาสสำหรับแสดงจำนวนเพื่อนทั้งหมดในป๊อปอัปรายชื่อเพื่อนอย่างเป็นทางการ

### พร็อพเพอร์ตี้

| ชื่อ      | ประเภท   | คำอธิบาย                                                                                                         |
| --------- | -------- | ---------------------------------------------------------------------------------------------------------------- |
| textCount | `string` | คืนค่าข้อความที่แปลแล้วสำหรับจำนวนเพื่อนทั้งหมด ข้อความจะถูกแปลเป็นภาษาที่ตรงกับการตั้งค่าของอุปกรณ์โดยอัตโนมัติ |