دوستان

از API های دوستان برای تکمیل و تقویت سیستم دوستان موجود در بازی و سایر سیستم های اجتماعی که ممکن است بازی شما به آن دسترسی داشته باشد استفاده کنید. این به شما امکان می دهد بازیکنان را قادر کنید:

  • دوستان آنها را در بازی خود پیدا کنید.

  • نمرات را با دوستان خود در تابلوهای امتیازات مقایسه کنید.

  • فهرست دوستان «بازی‌های Play» آن‌ها را با فهرست دوستان موجود درون بازی ترکیب کنید.

  • بازیکن دیگری را با یک پنجره بازشو نمایه درون بازی شناسایی کنید. این پاپ آپ یک نام مستعار را نشان می دهد که بازیکن فعلی به دوست خود داده است تا آنها بدانند با چه کسی بازی می کنند.

وارد کردن دوستان

مبانی

این API ها به شما امکان می دهند اقدامات زیر را انجام دهید:

  • بارگیری دوستان : می توانید بررسی کنید که آیا بازیکن به بازی اجازه داده است به اطلاعات لیست دوستان دسترسی داشته باشد. در صورت اعطای دسترسی، می توانید لیستی از اشیاء Player مربوط به دوستان بازیکن وارد شده را دریافت کنید.
  • نمایش نمایه بازی‌های Play بازیکن دیگری را راه‌اندازی کنید : می‌توانید این نما را باز کنید تا نامی را که بازیکن واردشده به بازیکن دیگر داده است نشان دهید. این نما همچنین کنترل های مدیریت دوستی را ارائه می دهد و بازیکن را از بازی شما خارج نمی کند.
  • ارائه کنترل‌های کاربر : کاربر کنترل‌هایی برای مدیریت نحوه مشاهده نمایه بازی‌های Play برای دوستان و نحوه مشاهده فهرست دوستانش برای بازی‌ها دارد. برای دسترسی به لیست دوستان، کاربر می تواند انتخاب کند که به طور خودکار برای همه بازی ها دسترسی اعطا شود یا می تواند به طور جداگانه برای هر بازی دسترسی را تأیید کند. در نتیجه، هنگام بارگیری لیست دوستان، نتیجه ممکن است یک تماس برای نمایش درخواست دسترسی باشد.

فهرست دوستان بازی های Play را وارد کنید

می‌توانید از APIهای دوستان برای دریافت لیستی از دوستان بازی‌های Play بازیکنان خود استفاده کنید و آنها را به لیست دوستان درون بازی خود اضافه کنید.

کاربران جدید یک لیست شروع از دوستان برای بازی خواهند داشت، و کاربران فعلی می‌توانند دوستان بازی‌های Play خود را به هر فهرستی از دوستان داخل بازی وارد کنند. در نتیجه، کاربران شما بزرگترین مجموعه ممکن از بازیکنان را برای بازی یا رقابت با آنها خواهند داشت.

دوستان Play Games را به بازی خود اضافه کنید

با مرتبط کردن شناسه بازی‌های Play آنها با اطلاعات بازیکن مربوطه در پایگاه داده داخلی خود، دوستان بازی‌های Play را به فهرست دوستان موجود در بازی اضافه کنید. مطمئن شوید که دکمه‌ای با نماد بازی‌های Play در کنار این دوستان دارید که با فشردن آن، نمایه بازیکن دیگر را نشان می‌دهد تا کاربران شما بتوانند بدانند دوستان چه کسانی هستند.

هنگام استفاده از لیست دوستان از یک سرور باطن، به جای ارسال نتیجه API Android، آن را با استفاده از REST API به طور ایمن بارگیری کنید . مطمئن شوید که از شناسه بازیکنی که توسط players.get(me) بازگردانده شده است در REST API برای بازیکنی که در حال حاضر وارد سیستم شده است استفاده کنید، زیرا این شناسه با شناسه مشاهده شده توسط بازیکنان دیگر مطابقت دارد.

اگر لیست دوستان افزوده شده ذخیره نمی شود (اما فقط در زمان مشاهده استفاده می شود)، پس نیازی به کار اضافی نیست.

به بازی‌های Play دسترسی بدهید

اگر بازی شما از قبل به بازی‌های Play دسترسی ندارد، زمان خوبی برای درخواست رضایت کاربران زمانی است که لیست دوستان درون بازی شما را مشاهده می‌کنند. برای مثال، می‌توانید دکمه‌ای به نام وارد کردن دوستان بازی‌های Play اضافه کنید، که در صورت ضربه زدن از کاربر درخواست رضایت می‌کند. (حتما از نشان‌واره «بازی‌های Play» روی هر دکمه‌ای که به خدمات اشاره می‌کند استفاده کنید.)

نمایه بازیکن دیگر را مشاهده کنید

می‌توانید به بازیکنی که به سیستم وارد شده اجازه دهید نمایه بازی‌های Play بازیکن دیگری را مشاهده کند. این به بازیکنی که وارد سیستم شده است اجازه می‌دهد نامی را که به بازیکن دیگر داده‌اند و اینکه آیا قبلاً دوست هستند یا خیر، ببیند، و به آنها زمینه بیشتری در مورد رابطه می‌دهد. اگر بازیکنان هنوز دوست نیستند، بازیکنی که وارد سیستم شده است، کنترل‌های مدیریت دوستی را در نمای نمایه مشاهده می‌کند. هنگامی که دوستی از داخل بازی ایجاد می شود، نام های پیش فرض برای دو بازیکن، نام های درون بازی آنها است (در صورت ارائه). نام بازی که در آن دوستی آغاز شد نیز نشان داده شده است.

نمایه بازیکن دیگر را مشاهده کنید

تابلوهای امتیازات اجتماعی

از API های دوستان می توان برای تابلوهای امتیازات نیز استفاده کرد. از این ویژگی برای نشان دادن رتبه بازیکن فعلی در میان دوستان Play Games خود استفاده کنید. توجه داشته باشید که این فقط برای کاربرانی اعمال می‌شود که انتخاب کرده‌اند این اطلاعات را با برنامه شما به اشتراک بگذارند و اگر کاربران در بازی‌های Play دوستان هستند. برای پشتیبانی از این ویژگی، بازی کنترلی را در اختیار کاربر قرار می دهد. این کنترل از آرگومان collection برای انتخاب نمای اجتماعی تابلوی امتیازات استفاده می کند. برای کسب اطلاعات بیشتر، به بخش تابلوهای امتیازات عمومی و اجتماعی مراجعه کنید.

اگر مجموعه تابلوهای امتیازات اجتماعی را پیاده‌سازی کنید، فراخوانی برای بارگیری امتیازهای تابلوی امتیازات ممکن است یک استثنای رزولوشن مورد نیاز رضایت مشابه با loadFriends() را برگرداند. اگر رابط کاربری پیش‌فرض ارائه‌شده توسط «بازی‌های Play» را پیاده‌سازی کنید (مثلاً getLeaderboardIntent() )، این به‌طور خودکار برای شما انجام می‌شود.

مراحل بعدی

قبل از شروع به استفاده از API های دوستان، موارد زیر را انجام دهید: