অ্যান্ড্রয়েড স্টুডিও প্রোজেক্টে ফ্রেন্ডস এপিআই কীভাবে ব্যবহার করবেন এই গাইডটি বর্ণনা করে।
বন্ধুদের লোড
আপনি বর্তমান ব্যবহারকারীর সাথে বন্ধুত্বপূর্ণ খেলোয়াড়দের একটি তালিকা (গেমে) পুনরুদ্ধার করতে এবং প্রদর্শন করতে পারেন। একজন ব্যবহারকারী হিসাবে, বন্ধুদের তালিকায় কোন গেমগুলির অ্যাক্সেস রয়েছে তা নিয়ন্ত্রণ করা সম্ভব। আপনি যখন বন্ধুদের তালিকা পুনরুদ্ধার করবেন, আপনাকে অবশ্যই সেই ক্ষেত্রে পরিচালনা করতে হবে যেখানে অনুমতির প্রয়োজন হয়৷ অ্যাক্সেসের অনুরোধ করার জন্য এবং পরবর্তীতে বন্ধুদের তালিকা ব্যবহার করে সহজবোধ্য কাজ করার জন্য এগুলি সবই API এ এনক্যাপসুলেট করা হয়েছে। বন্ধুদের তালিকা লোড করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
-
PlayersClient.loadFriends()
পদ্ধতিতে কল করুন, এটি একটি অ্যাসিঙ্ক্রোনাস কল যা একটিTask
অবজেক্ট ফেরত দেয়। - যদি কলটি সফল হয় (ব্যবহারকারী ইতিমধ্যেই বন্ধুদের তালিকায় অ্যাক্সেস মঞ্জুর করেছে), Google Play গেম পরিষেবাগুলি একটি টীকাযুক্ত
PlayerBuffer
প্রদান করে যা ব্যবহারকারীর বন্ধুদের প্রতিনিধিত্ব করে। যদি প্লেয়ারকে বন্ধুদের তালিকায় অ্যাক্সেস দেওয়ার প্রয়োজন হয়, তাহলে একটি
FriendsResolutionRequiredException
এর সাথে কলটি ব্যর্থ হয়। কোন ডায়ালগ এখনও দেখানো হয় না.- এই ব্যতিক্রমটিতে একটি
Intent
রয়েছে যা প্লেয়ারের সম্মতি চাওয়ার জন্য একটি ডায়ালগ ট্রিগার করে। আপনি একটি সম্মতি ডায়ালগ খুলতে অবিলম্বে এইIntent
চালু করতে পারেন। আপনি শুধুমাত্র একবার এইIntent
ব্যবহার করতে পারেন. যদি
Intent
কার্যকলাপের ফলাফল হয়Activity.RESULT_OK
, তাহলে সম্মতি দেওয়া হয়েছিল। বন্ধুদের তালিকা ফেরত দিতে আবারloadFriends()
কল করুন। যদি ফলাফলটি হয়Activity.RESULT_CANCELLED
, ব্যবহারকারী সম্মতি দেননি এবংloadFriends()
FriendsResolutionRequiredException
ফেরত দিতে থাকবে।
- এই ব্যতিক্রমটিতে একটি
নিম্নলিখিত কোডটি দেখায় কিভাবে বন্ধুদের তালিকা লোড করতে হয়:
// Attempt loading friends.
// Register a success listener to handle the successfully loaded friends list.
// Register a failure listener to handle asking for permission to access the list.
PlayGames.getPlayersClient(this)
.loadFriends(PAGE_SIZE, /* forceReload= */ false)
.addOnSuccessListener(
new OnSuccessListener<AnnotatedData<PlayerBuffer>>() {
@Override
public void onSuccess(AnnotatedData<PlayerBuffer> data) {
PlayerBuffer playerBuffer = data.get();
// ...
})
.addOnFailureListener(
exception -> {
if (exception instanceof FriendsResolutionRequiredException) {
PendingIntent pendingIntent =
((FriendsResolutionRequiredException) task.getException())
.getResolution();
parentActivity.startIntentSenderForResult(
pendingIntent.getIntentSender(),
/* requestCode */ SHOW_SHARING_FRIENDS_CONSENT,
/* fillInIntent */ null,
/* flagsMask */ 0,
/* flagsValues */ 0,
/* extraFlags */ 0,
/* options */ null);
}
});
return;
}
নিম্নলিখিত কোডটি দেখায় কিভাবে সম্মতির অনুরোধ থেকে ফলাফল পরিচালনা করতে হয়:
/** Handle the activity result from the request for consent. */
@Override
public void onActivityResult(int requestCode, int result, Intent data) {
if (requestCode == SHOW_SHARING_FRIENDS_CONSENT) {
if (result == Activity.RESULT_OK) {
// We got consent from the user to access their friends. Retry loading the friends
callLoadFriends();
} else {
// User did not grant consent.
}
}
}
অন্য খেলোয়াড়ের প্রোফাইল দেখুন
আপনি আপনার গেমের মধ্যে থেকে অন্য প্লেয়ারের প্লে গেমস প্রোফাইলের একটি দৃশ্য প্রদর্শন করতে পারেন। এই ভিউ খেলোয়াড়দের দেখার জন্য বন্ধুদের আমন্ত্রণ পাঠাতে এবং গ্রহণ করতে দেয়। এই দৃশ্যের জন্য বন্ধুদের তালিকায় প্রবেশের প্রয়োজন নেই। উপরন্তু, যদি আপনার গেমের প্লে গেম গেমার আইডি থেকে আলাদা প্লেয়ারের নামের নিজস্ব ধারণা থাকে, তাহলে আপনি এগুলিকে প্রোফাইল ভিউতে পাস করতে পারেন যাতে অতিরিক্ত প্রসঙ্গের জন্য যেকোনো বন্ধুর আমন্ত্রণে অন্তর্ভুক্ত করা যায়।
অন্য খেলোয়াড়ের প্রোফাইল দেখাতে, এই পদক্ষেপগুলি অনুসরণ করুন:
-
PlayersClient.getCompareProfileIntent()
পদ্ধতিতে কল করুন, যা একটিTask
অবজেক্ট ফেরত একটি অ্যাসিঙ্ক্রোনাস কল। - কলটি সফল হলে, Google Play Games Services একটি ইন্টেন্ট প্রদান করে যা একটি স্ক্রীন প্রদর্শন করবে যেখানে ব্যবহারকারী অন্য খেলোয়াড়ের প্রোফাইলের সাথে নিজেদের তুলনা করতে পারবে।
- একটি কার্যকলাপ শুরু করতে পূর্ববর্তী ধাপ থেকে
Intent
ব্যবহার করুন.
// Retrieve and launch an Intent to show a player profile within the game.
PlayGames.getPlayersClient(this)
.getCompareProfileIntent(otherPlayerId)
.addOnSuccessListener(new OnSuccessListener<Intent>() {
@Override
public void onSuccess(Intent intent) {
startActivityForResult(intent, RC_SHOW_PROFILE);
// ...
}});
খেলোয়াড়দের জন্য গেমটির নিজস্ব নাম থাকলে, এগুলি API কলে যোগ করা যেতে পারে। এটি প্লে গেমগুলিকে সেই খেলোয়াড়দের ডাকনাম সেট করতে সক্ষম করে যারা আপনার গেমের মধ্যে থেকে "<game-specific-name> থেকে <your-game-name>" থেকে <your-game-name>" এ স্বয়ংক্রিয়ভাবে যোগ হয়ে যায়। ):
// Show a player profile within the game, with additional hints containing the
// game-specific names for both players.
// - otherPlayerId is the Play Games playerId of the player to view.
// - otherPlayerInGameName is the game-specific name of the player being viewed.
// - currentPlayerInGameName is the game-specific name of the player who is signed
// in. Hence if the player sends an invitation to the profile they are viewing,
// their game-specific name can be included.
PlayGames.PlayersClient(this)
.getCompareProfileIntentWithAlternativeNameHints(otherPlayerId, otherPlayerInGameName, currentPlayerInGameName)
.addOnSuccessListener(new OnSuccessListener<Intent>() {
@Override
public void onSuccess(Intent intent) {
startActivityForResult(intent, RC_SHOW_PROFILE);
// ...
}});