配置流程

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打开配置界面

android facebook 登录sdk 获取用户信息 facebook sdk接入_ide

基本设置

AppName可以随便写
Facebook App Id为后台的应用编号
ClientToken为 后台中:设置–>高级页面 客户端口令

FB.Init()

使用默认即可

Android Build Facebook Setting

这部分的设置内容是自动生成的,无法手动输入,为了能够自动生成信息,需要配置好本地的环境,有以下需要注意的点:

1, 这里要求jdk要使用jdk8。且要配置jdk环境变量。

下图为笔者机器jdk设置

android facebook 登录sdk 获取用户信息 facebook sdk接入_ide_02


一开始红框处是勾选的,即使用unity安装包里面的jdk。报错Keytool not found.Make sure that Java is installed,and that Java tools are in your path

android facebook 登录sdk 获取用户信息 facebook sdk接入_其他_03


即要求配置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的值

android facebook 登录sdk 获取用户信息 facebook sdk接入_ide_04


这里补充一下OpenSSL配置流程

2.1,下载

https://storage.googleapis.com/google-code-archive-downloads/v2/code.google.com/openssl-for-windows/openssl-0.9.8e_X64.zip 2.2 配置

上述下载的为非安装包,解压后,我直接丢到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

android facebook 登录sdk 获取用户信息 facebook sdk接入_java_05


上述无论是配置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的地方打了黑马):

android facebook 登录sdk 获取用户信息 facebook sdk接入_android_06

上述都配置好后,把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客户端后,出现分享页面。点击分享按钮后,会刷新一下,页面不关闭;点击返回按钮的话也一样,刷新一下,页面不关闭,无法回到游戏界面。有时候偶尔还会造成软件重启