最近因为需求对Facebook游戏邀请功能做了调研,拿出来给有需要的同学分享下!
简介:
游戏邀请功能,说白了就是发送邀请给朋友,邀请朋友一起玩游戏;
你可以指定好友发送邀请,也可以给多个好友发送邀请。
主要的流程:
在游戏中点击 邀请,拉起fb游戏服务的邀请接口,进入好友列表界面,选择需要邀请的朋友,然后发送邀请;成功后会返回邀请ID,这个ID可以和用户ID拼接起来,组成一个唯一标识,保存起来,用于朋友点击链接进入游戏后给邀请者发放奖励。
缺点:
此功能有个很鸡肋的点,就是如果你没有安装此游戏,点击邀请链接后你会先跳转到应用中心(Google play)下载应用,然后还需要重新再点击一次邀请链接,邀请才会成功,否则邀请不成功。
简单的说就是,如果你没有安装该应用,受邀人就必须点击两次邀请链接才会被邀请成功。
核心代码:
官方文档:fb游戏邀请
引用库:implementation ‘com.facebook.android:facebook-android-sdk:11.1.0’
GameRequestDialog requestDialog;
CallbackManager callbackManager;
public void onCreate (Bundle savedInstanceState){
super.onCreate(savedInstanceState);
FacebookSdk.sdkInitialize(this.getApplicationContext());
callbackManager = CallbackManager.Factory.create();
requestDialog = new GameRequestDialog(this);
requestDialog.registerCallback(callbackManager,
new FacebookCallback<GameRequestDialog.Result>() {
public void onSuccess(GameRequestDialog.Result result) {
//此处是请求ID,每次不同,会变
String requestId = result.getRequestId();
List<String> list = result.getRequestRecipients();
for (int i = 0; i < list.size(); i++) {
// 邀请了那几个fb好友(fb id),此处获取的是用户ID,唯一,不变
request_id = requestId + "_" + list.get(i);
Log.e("测试", "request_ids = " + requestId + "_" + list.get(i));
}
}
public void onCancel() {
}
public void onError(FacebookException error) {
}
}
);
}
private void onClickRequestButton () {
GameRequestContent content = new GameRequestContent.Builder()
.setMessage("Come play this level with me")
.build();
requestDialog.show(content);
}
protected void onActivityResult ( int requestCode, int resultCode, Intent data){
super.onActivityResult(requestCode, resultCode, data);
callbackManager.onActivityResult(requestCode, resultCode, data);
}
邀请成功后会返回请求ID和被邀请好友的ID,可以把请求ID和好友ID拼接起来做唯一标识保存,用于发放奖励。
GameRequestContent可设置的属性,详情请查看官网
设置to属性指定发送人,如果没有设置,则默认显示所有好友!
以上发送邀请的流程就已经完成了。
接下来要做的是什么呢!?当然是检测是否邀请成功,然后发放奖励。
点击链接跳转到应用,获取跳转链接中的请求参数
在AndroidManifest.xml中,启动的activity加入以下配置:
<activity android:name="com.demo.MainActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
<intent-filter>
<action android:name="android.intent.action.VIEW"/>
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="https" android:host="m.facebook.com" />
</intent-filter>
</activity>
在启动activity onCreate() 中获取跳转链接参数:
getIntent().getDataString()
获取到的链接是这样的:
https://m.facebook.com/appcenter/xxx?fbs=1001&request_ids=xxxxxxxxxxx&ref=notif&app_request_type=user_to_user
其中的request_ids可以和userId拼接起来,发送到自己的后台服务器中进行匹配,发放奖励。
发奖后需要删除邀请请求,不然,,,你懂的,刷,,,
删除请求的方式如下:
客户端进行网络请求,请注意要使用get方式。
https://graph.facebook.com/[{REQUEST_OBJECT_ID}_{USER_ID}]?method=delete&access_token=[USER or APP ACCESS TOKEN]
删除成功:
{
"success": true
}
特别提示:应用要过审了,发送的邀请请求别人才能收到
至此,Facebook邀请功能算是完成了!