ميزتك التالية

الأصدقاء

الأصدقاء والطلبات والحظر في المشروع المحدد.

SDK: فرع developتتطلب جلسة لاعب

Unity

النتيجة المرئية

بعد مهلة أو تعارض، حدّث وراجع القصد. لا تعاود تلقائياً بمراجعة جديدة.

الفيديو قادم لاحقًا

لا يوجد فيديو لهذه الخطوة بعد. الدليل وطلب MCP متاحان للاستخدام.

الأصدقاء

جهّزوا المشروع نفسه

اختر في لوحة التحكم المشروع نفسه الموجود في إعداد لعبتك.
الأصدقاء →
لا يحتاج الطلب الأول إلى تعريف إضافي. النتيجة الفارغة صالحة ما دامت بيانات اللعبة المطابقة غير موجودة.
استخدموا جلستين منفصلتين للاعبين في المشروع نفسه. انسخوا UUID الدقيق للاعب الآخر من إدارة المستخدمين.
استخدم UUID مطابقاً أو رمز H قياسياً. لا تقبل الأسماء والبريد.
للعرض فقط؛ جلسة اللاعب نفسه وحدها تغير العلاقات.

أضف هذه الميزة

يمكنك الاطلاع على الدليل. يتطلب التنفيذ مفتاح مشروع نشطًا. تجهيز المشروع

SDK مُثبّت وإعداد المشروع مُستورد واللاعب مسجّل الدخول.

يستخدم مثال SDK هذا فرع develop. تحقّق من وجود واجهات API المطلوبة في SDK المثبّت.

أكملوا اتصال البدء السريع باللاعب المقصود. استدعوا RunReviewedAction() بزر أو إجراء مشهد صريح. فتح الملف وحده لا يرسل طلباً.

Assets/Scripts/FriendsDemo.cs

استدعاء horizOn

1using UnityEngine;

2using PM.horizOn.Cloud.Core;

3using PM.horizOn.Cloud.Manager;

5// Existing SDK/project configuration and authenticated player session required.

6// Call RunReviewedAction explicitly after reviewing this example and its data.

7// بعد مهلة أو تعارض، حدّث وراجع القصد. لا تعاود تلقائياً بمراجعة جديدة.

8public sealed class FriendsDemo : MonoBehaviour

10 public async void RunReviewedAction()

11 {

12 var sessionUser = UserManager.Instance.CurrentUser;

13 if (sessionUser == null || !sessionUser.IsValid()) return;

14 var userId = UserManager.Instance.CurrentUser.UserId;

15 var manager = FriendsManager.Instance;

16 var loaded = await manager.GetFriends(userId);

17 if (!loaded.IsSuccess) { Debug.LogWarning(loaded.ErrorCode); return; }

18 Debug.Log(loaded.Data.friendCode); // Public identifier, not a credential.

19 foreach (var friend in loaded.Data.friends)

20 Debug.Log(friend.display.name + ": " + (friend.lastActiveAt ?? "unknown"));

22 // Invoke only after the player explicitly reviews this snapshot and chooses an action.

23 async System.Threading.Tasks.Task ApplyReviewed(string action, string targetUserId,

24 long expectedRevision, string requestId = null)

25 {

26 var result = action switch {

27 "request" => await manager.SendRequest(userId, targetUserId, expectedRevision),

28 "accept" => await manager.AcceptRequest(userId, targetUserId, expectedRevision, requestId),

29 "decline" => await manager.DeclineRequest(userId, targetUserId, expectedRevision, requestId),

30 "cancel" => await manager.CancelRequest(userId, targetUserId, expectedRevision, requestId),

31 "remove" => await manager.RemoveFriend(userId, targetUserId, expectedRevision),

32 "block" => await manager.BlockPlayer(userId, targetUserId, expectedRevision),

33 "unblock" => await manager.UnblockPlayer(userId, targetUserId, expectedRevision),

34 _ => throw new System.ArgumentException("Unknown action")

35 };

36 if (!result.IsSuccess) {

37 Debug.LogWarning(result.ErrorCode); // Timeout/409: reload and reconcile; do not repeat automatically.

38 return;

39 }

40 Debug.Log(result.Data.revision); // Replace the whole displayed snapshot.

41 }

42 // Accept/decline: original incoming requestId. Cancel: original outgoing requestId.

43 // Never replace expectedRevision on an uncertain retry. A new request is a new identity.

44 // FindPlayer(userId, exactUuidOrHCode) never searches names or emails.

45 // Last login is nullable, never an online flag. No hidden polling timer.

46 }

47}

فتح مثال SDK الكامل ↗

اختبر ميزتك الجديدة.

بعد مهلة أو تعارض، حدّث وراجع القصد. لا تعاود تلقائياً بمراجعة جديدة.

اختر في لوحة التحكم المشروع نفسه الموجود في إعداد لعبتك.

التحقّق في لوحة التحكم العثور على هدف آخر للعبة

نقاط النهاية

GET/friends
GET/friends/find
POST/friends/request
POST/friends/accept
POST/friends/decline
POST/friends/cancel
POST/friends/remove
POST/friends/block
POST/friends/unblock

كل نقاط النهاية في مرجع API

التوثيق ولوحة التحكم

اقرأ التوثيق

اقتراحنا لخطوتك التالية

أضف رقمًا قياسيًا لكل جولة.

احفظ النتيجة بعد الجولة وأظهر المتصدر. واصل استخدام اتصالك وجلسة اللاعب.

إضافة لوحة صدارة إضافة عبر وكيل MCP

احتفظ بكل التقدم.الحفظ السحابي · الكود وطلب MCP

اضبط لعبتك بينما يواصل اللاعبون اللعب.التكوين عن بُعد · الكود وطلب MCP