Unity接入Facebook SDK--android篇

配置流程

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，下载
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

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

笔者后用Google手机测试，一切正常。这个应该是国产手机魔改导致FB SDK无法兼容。可以参考这个博文Android App接入Facebook分享SDK时，无法启动Facebook客户端的问题分析

参考文档

Unity 接入Facebook SDK