配置流程
1,开发者后台创建应用
https://developers.facebook.com/apps/
2,下载Unity版本SDK,导入Unity
https://developers.facebook.com/docs/unity/ 下载的Unity package包包含sdk和demo工程。根据demo工程可以很容易进行代码移植。
3,Facebook SDK for Unity Reference
各种示例和API详细解说:Facebook SDK for Unity Reference
4,配置
Facebook–>Edit Settings打开配置界面
基本设置
AppName可以随便写
Facebook App Id为后台的应用编号
ClientToken为 后台中:设置–>高级页面 客户端口令
FB.Init()
使用默认即可
Android Build Facebook Setting
这部分的设置内容是自动生成的,无法手动输入,为了能够自动生成信息,需要配置好本地的环境,有以下需要注意的点:
1, 这里要求jdk要使用jdk8。且要配置jdk环境变量。
下图为笔者机器jdk设置
一开始红框处是勾选的,即使用unity安装包里面的jdk。报错Keytool not found.Make sure that Java is installed,and that Java tools are in your path:
即要求配置jdk环境变量。
笔者先下载了jdk13,配置好后,Preferences浏览选择jdk目录的时候直接报错提示只支持jdk8。
于是只能换jdk8安装。2,配置OpenSSL
未配置前,报错OpenSSL not found,Make sure that OpenSSL is installed,and that it is in your path。且无法生成Debug Android Key Hash
的值
这里补充一下OpenSSL配置流程
2.1,下载
上述下载的为非安装包,解压后,我直接丢到C盘根目录了。
2.2.1 系统环境变量Path中新建 C:\openssl-0.9.8e_X64\bin
2.2.2 新建系统环境变量OPENSSL_CONF,值为openssl.cnf的路径,笔者的是C:\openssl-0.9.8e_X64\openssl.cnf
上述无论是配置jdk还是OpenSSL,配置好后,重启Unity,便解决之前的报错提示。同时Debug Android Key Hash也会自动生成。需要复制该值,配置到FB开发者后台。
(补充:Android Key Hash的生成,详见该文。上面配置好OpenSSL,自动生成的Debug Android Key Hash其实是默认的keystore文件生成的散列值,当我们用自己的keystore文件出包后,进行FB登录后日志会报错,且会把正确的散列值打印出来,这个时候只需要把这个散列值再配置到开发者后台,就可以正确登录了。当然使用链接中提供的keytool命令也是可以获得正确的散列值的)都设置好了。点击一下Regenerate Android Manifest
。
笔者最终生成的Android Manifest文件如下(涉及到包名和id的地方打了黑马):
上述都配置好后,把Class Name配置到FB后台(默认的是com.facebook.unity.FBUnityDeepLinkingActivity),有朋友说需要配置游戏真正的启动Activity名字。这里笔者用的默认的,暂时没有发现什么问题。
- 20220620补充
在使用13.2.0版本时报错clientToken没有设置(虽然我在设置界面配置了,但是打包后通过解包在andoirmanifest.xml中确实没看到,应该是这个版本的bug),需要手动在androidmanifest.xml中配置<meta-data android:name="com.facebook.sdk.ClientToken" android:value="ClientToken值"/>
5,打包后闪退
笔者把demo工程打包apk后,闪退,报错如下
02-26 16:01:37.248 15866-15866/? E/AndroidRuntime: FATAL EXCEPTION: main
Process: com.wildcasino.slotsgame.free.casinoslots, PID: 15866
java.lang.RuntimeException: Unable to get provider com.facebook.FacebookContentProvider: java.lang.ClassNotFoundException: Didn't find class "com.facebook.FacebookContentProvider" on path: DexPathList[[zip file "/data/app/com.wildcasino.slotsgame.free.casinoslots-1.apk"],nativeLibraryDirectories=[/data/app-lib/com.wildcasino.slotsgame.free.casinoslots-1, /vendor/lib, /system/lib]]
at android.app.ActivityThread.installProvider(ActivityThread.java:4909)
at android.app.ActivityThread.installContentProviders(ActivityThread.java:4501)
at android.app.ActivityThread.handleBindApplication(ActivityThread.java:4436)
at android.app.ActivityThread.access$1500(ActivityThread.java:147)
at android.app.ActivityThread$H.handleMessage(ActivityThread.java:1271)
at android.os.Handler.dispatchMessage(Handler.java:102)
at android.os.Looper.loop(Looper.java:136)
at android.app.ActivityThread.main(ActivityThread.java:5135)
at java.lang.reflect.Method.invokeNative(Native Method)
at java.lang.reflect.Method.invoke(Method.java:515)
at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:798)
at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:614)
at dalvik.system.NativeStart.main(Native Method)
Caused by: java.lang.ClassNotFoundException: Didn't find class "com.facebook.FacebookContentProvider" on path: DexPathList[[zip file "/data/app/com.wildcasino.slotsgame.free.casinoslots-1.apk"],nativeLibraryDirectories=[/data/app-lib/com.wildcasino.slotsgame.free.casinoslots-1, /vendor/lib, /system/lib]]
at dalvik.system.BaseDexClassLoader.findClass(BaseDexClassLoader.java:56)
at java.lang.ClassLoader.loadClass(ClassLoader.java:497)
at java.lang.ClassLoader.loadClass(ClassLoader.java:457)
at android.app.ActivityThread.installProvider(ActivityThread.java:4894)
at android.app.ActivityThread.installContentProviders(ActivityThread.java:4501)
at android.app.ActivityThread.handleBindApplication(ActivityThread.java:4436)
at android.app.ActivityThread.access$1500(ActivityThread.java:147)
at android.app.ActivityThread$H.handleMessage(ActivityThread.java:1271)
at android.os.Handler.dispatchMessage(Handler.java:102)
at android.os.Looper.loop(Looper.java:136)
at android.app.ActivityThread.main(ActivityThread.java:5135)
at java.lang.reflect.Method.invokeNative(Native Method)
at java.lang.reflect.Method.invoke(Method.java:515)
at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:798)
at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:614)
at dalvik.system.NativeStart.main(Native Method)
上述报错信息找到关键字Unable to get provider com.facebook.FacebookContentProvider: java.lang.ClassNotFoundException: Didn't find class "com.facebook.FacebookContentProvider" on path: DexPathLis
这个报错原因是引入打包之前没有引入FB相关的依赖库,相关依赖在FacebookSDK/Plugins/Editor/Dependencies.xml
中有配置,可以通过AndroidResolver工具来自动引入。
建议处理方式:
step1:“/Assets/Play Service Resolver/Android Resolver/Delete Resolved Libraries”
step2:“/Assets/Play Service Resolver/Android Resolver/Resolve”
即,先把库清掉,再重新引入。
基本功能接入
0,初始化
FB.Init()
初始化成功后,FB.IsInitialized为true
1,登录
Facebook的功能都跟权限挂钩的,提供了两种方式的登录, LogInWithReadPermissions 和 LogInWithPublishPermissions。
你可以根据自己需要的接入的功能选择登录方式,并传入权限参数。
FB权限参考这里
登录成功后,FB.IsLoggedIn为true, 同时IResult的JSON格式数据RawResult包含user_id和access_token。
用户要获得更多信息,需要二次请求(客户端或者服务端取)。
默认情况下可以获得first_name,last_name,gender,email信息
更多的信息,比如location,需要商务权限,需要运营联系facebook客服开通注意:在测试期间,登录的测试fb账号需要加入到后台,否则登录会报错
2020022更新,新版本FB后台已不需要,且已经没有发布按钮!!!
更多登录相关参考:Facebook Login For Gaming
2,打点,埋点,事件
集成文档API文档注意:埋点不要求用户登录FB,但是需要完成SDK初始化,函数:
public static void LogAppEvent(
string logEventName,
float valueToSum,
Dictionary<string, object> parameters = null
)
3,分享
分享不要求用户登录FB,但是需要完成SDK的初始化
官方文档 函数:
public static void ShareLink(
Uri contentURL = null,
FacebookDelegate<IShareResult> callback = null)
)
荔枝:
FB.ShareLink(
new Uri("https://developers.facebook.com/"),
callback: ShareCallback
);
需要注意的是FB Unity SDK提供的FB.ShareLink函数,依旧支持很多参数,如下:
public static void ShareLink(Uri contentURL = null, string contentTitle = "", string contentDescription = "", Uri photoURL = null, FacebookDelegate<IShareResult> callback = null);
但是传入Title,content等内容后,并不能生效,只有contentURL会生效。因此建议使用命名参数的方式只传两个参数:uri和callback
如若有需求定制Title、Content、Photo的需求,需要自己创建一个web站点,保证web目录下的index文件能够被正确的访问到,设置index文件的meta信息。具体说明可以参考这里:A Guide to Sharing for Webmasters
Facebook爬虫会根据meta信息组合成正确的分享界面。Facebook提供有分享调试器的预览工具,用户输入url即可获得预览效果。
开发者配置index文件,在其header中添加如下meta信息:
<meta property="og:locale" content="en_US" />
<meta property="og:type" content="website" />
<meta property="og:title" content={YOUR TITLE} />
<meta property="og:description" content={YOUR DESCRIPTION} />
<meta property="og:url" content={YOUR URL} />
<meta property="og:image" content={YOUR IMAGE URL} />
比如og:image就是分享显示的图片,我们可以把图片放到第三方网站或者图床上,把地址填在这个meta中。这样最终FB分享中就会有这个图片的显示了。注意1:测试期间需要把测试分享的fb账号添加到fb后台,否则会报错
3.1 国产手机的坑
笔者使用meizu的一款手机测试FB SDK,登录没问题。分享遇到各种问题,包括以下情形:
- 机器装了FB客户端,点击分享后有小概率拉不起FB的客户端,日志报错类似于没有FB APP这样子的信息
- 点击分享后拉起的是FB网页登录
- 拉起FB客户端后,出现分享页面。点击分享按钮后,会刷新一下,页面不关闭;点击返回按钮的话也一样,刷新一下,页面不关闭,无法回到游戏界面。有时候偶尔还会造成软件重启