ZEPETO.Module.Social

30 นาที

ประเภท	คำอธิบาย
SocialService	SocialService ใช้งานฟังก์ชันทางสังคมภายใน ZEPETO World บริการนี้ช่วยให้ผู้เล่นเข้าถึงข้อมูลทางสังคม เช่น ความสัมพันธ์การติดตามของผู้ใช้ และยังมีความสามารถในการส่งข้อความส่วนตัวถึงผู้เล่นคนอื่น
RoomMemberStatus	Enum ที่แสดงความสัมพันธ์กับ local player
MyFollowerListResponse	คลาส MyFollowerListResponse ให้ข้อมูลรายชื่อผู้ติดตามของ local player
MyFollowingListResponse	คลาส MyFollowingListResponse ให้ผลลัพธ์การเรียก API และข้อมูลรายชื่อที่ local player ติดตามอยู่
UserFollowInfoListResponse	คลาส UserFollowInfoListResponse ให้ผลลัพธ์การเรียก API และรายการข้อมูลการติดตามของผู้ใช้หลายคน
UserFollowInfoResponse	คลาส UserFollowInfoResponse ให้ผลลัพธ์การเรียก API และรายการข้อมูลการติดตามของผู้ใช้
UserFollowStatusResponse	คลาส UserFollowStatusResponse ให้ผลลัพธ์การเรียก API และข้อมูลที่ระบุว่าผู้ใช้ที่กำหนดมีความสัมพันธ์การติดตามกับ local player หรือไม่
DirectMessagePopupState	แจกแจงสถานะของป๊อปอัปข้อความส่วนตัว
UserInfo	ข้อมูลผู้ใช้
UserFollowInfo	ข้อมูลการติดตามของผู้ใช้
UserAccountType	Enum ที่แสดงประเภทบัญชีผู้ใช้
FollowStatus	แสดงความสัมพันธ์การติดตามกับ local player
FollowCellView	คลาสสำหรับป๊อปอัปรายชื่อเพื่อนอย่างเป็นทางการ
UserInfoCellView	คลาสสำหรับองค์ประกอบ UI ที่แสดงข้อมูลเพื่อนในป๊อปอัปรายชื่อเพื่อนอย่างเป็นทางการ
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[]	ข้อมูลของผู้ใช้ที่ติดตาม local player
nextPageToken	string	เมื่อมีรายการจำนวนมาก nextPageToken จะรวมอยู่ในการตอบกลับ ทำให้สามารถดึงรายชื่อผู้ติดตามชุดถัดไปได้ หากไม่มีรายการเหลืออยู่ nextPageToken จะมีค่าเป็น null

MyFollowingListResponse

class · extends PlayBaasResponse

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

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

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

UserFollowInfoListResponse

class · extends BaseResponse

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

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

ชื่อ	ประเภท	คำอธิบาย
users	UserFollowInfo[]	อาร์เรย์ของรายการข้อมูลการติดตามของผู้ใช้หลายคน

UserFollowInfoResponse

class · extends BaseResponse

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

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

ชื่อ	ประเภท	คำอธิบาย
user	UserFollowInfo	อาร์เรย์ของรายการข้อมูลการติดตามของผู้ใช้

UserFollowStatusResponse

class · extends PlayBaasResponse

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

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

ชื่อ	ประเภท	คำอธิบาย
status	FollowStatus	ความสัมพันธ์การติดตามระหว่างผู้ใช้ที่กำหนดกับ local player

DirectMessagePopupState

enum

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

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

UserInfo

class

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

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

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

เมธอด

GetProfileThumbnailAsync

GetProfileThumbnailAsync() → BaseRequest<TextureResponse>

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

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

GetBadgeImageAsync

GetBadgeImageAsync() → BaseRequest<TextureResponse>

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

UserFollowInfo

class · extends 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

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

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

ชื่อ	ประเภท	คำอธิบาย
userInfo	UserInfo	คืนค่าข้อมูลผู้ใช้ที่แสดงบน UI
textName	string	คืนค่าชื่อผู้ใช้ของบัญชีที่แสดงบน UI

TotalCountCellView

class · extends FollowCellView

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

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

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