【Unity】ShareSDK、SMSSDK的基本使用與常見問題

概要

測試使用ShareSDK的一些常用功能。包括：

• 用微博帳號做第三方登錄
• 獲取用戶的帳號詳細信息
• 獲取好友列表
• 分享功能

測試使用SMSSDK插件，包括：

• 導入插件，解決包沖突
• 短信登錄功能：發驗證碼，收驗證碼，比對驗證碼

學習資料：

• 官方文檔 http://wiki.mob.com/unity3d%E5%BF%AB%E9%80%9F%E9%9B%86%E6%88%90%E6%8C%87%E5%8D%97/
• 官方Demo https://github.com/MobClub/New-Unity-For-ShareSDK
• 視頻教程 http://www.sikiedu.com/course/140

 

---

 

用微博帳號做第三方登錄

1、在mob.com上注冊帳號，添加一個應用，給該應用添加ShareSDK。

2、登錄微博開放平台，填寫開發者信息。添加一個應用，確定安卓包名，下載微博提供的簽名生成工具（md5簽名生成器apk），安裝到安卓手機上。打開工具輸入安卓包名，得到簽名字符串。把包名和簽名填上。在OAuth2.0授權設置中輸入回調頁url。

3、打開Unity新建一個項目，Player Settings中填上上面的包名，自己的密鑰庫和密鑰。

4、下載ShareSDK for Unity，把包里的ShareSDK.unitypackage導入到項目中。

5、新建一個場景取名Init，一個空物體（可取名ShareSDKManager），專門用於存放全游戲中通用的（可跨場景長的、生命周期的）數據，開始游戲時先進入該場景，執行ShareSDK初始化，然后再跳轉到其他游戲場景。該場景只會進入一次。

6、給ShareSDKManager物體掛上Share SDK腳本，填上在微博開放平台中給的App Key，App Secret和回調頁路徑Redirect Url（默認填的是官方給的Debug帳號的信息）。

7、在腳本的Dev Info中打開本次測試id新浪微博Sinaweibo進行修改。其他不用管，默認都填的官方給的Debug帳號信息。

 

8、新建一個ShareSDKManager腳本，掛載到 ShareSDKManager物體上。

using cn.sharesdk.unity3d;
using UnityEngine;

public class ShareSDKManager : MonoBehaviour {
    private static ShareSDKManager _instance;
    public static ShareSDKManager Instance {
        get {
            return _instance;
        }
    }

   [HideInInspector]
    public PlatformType userPlatform = PlatformType.Unknown; // 用戶登錄的平台（是微博登錄還是短信登錄）
    [HideInInspector]
    public string userID = "";
    [HideInInspector]
    public ShareSDK ssdk; 

    void Start () {
        _instance = this;
        DontDestroyOnLoad(gameObject);
        ssdk= gameObject.GetComponent<ShareSDK>();
        // ShareSDK.Awake()中已經執行了shareSDKUtils.InitSDK(appKey,appSecret)初始化操作，這里是否寫初始化可隨意
        // 初始化完成后，跳轉場景
        UnityEngine.SceneManagement.SceneManager.LoadScene(1);
    }
}

9、新建一個場景取名Login，這是在Init場景之后進入的登錄頁面場景。新建腳本Login，掛到新建的LoginManager物體上。場景中的【用新浪微博登錄】按鈕觸發該物體中Login腳本對應的方法。登錄方法的流程參考下圖。這里以應用沒有用戶系統的體系為例。

using cn.sharesdk.unity3d;
using System.Collections;
using UnityEngine;
using UnityEngine.SceneManagement;

public class Login : MonoBehaviour {

    ShareSDK ssdk;
    void Start () {
        ssdk= ShareSDKManager.Instance.shareSDK;
        ssdk.authHandler = OnAuthResultHandler; // 授權結果的回調函數
    }
    
    // 用新浪微博登錄
    public void OnSinaLoginButtonClick()
    {
        if (ssdk.IsAuthorized(PlatformType.SinaWeibo)) // 檢測指定的平台是否已經授權過了
        {
   　　　　  // 寫入授權信息
            Utility.WriteFile(Application.persistentDataPath, "AuthInfo.txt", ssdk.GetAuthInfo(PlatformType.SinaWeibo).toJson());
            Utility.MakeToast("微博用戶：" + ssdk.GetAuthInfo(PlatformType.SinaWeibo)["userName"] + "\n登錄成功！"); // 信息詳情查看輸入的文件
            ShareSDKManager.Instance.userPlatform = PlatformType.SinaWeibo;
            SceneManager.LoadScene(2);
        }
        else // 指定的平台尚未授權，給它授權
        {
            ssdk.Authorize(PlatformType.SinaWeibo);
        }
    }

    /// <summary>
    /// 授權結果的回調函數
    /// </summary>
    /// <param name="reqID"></param>
    /// <param name="state">授權狀態：成功，失敗，取消</param>
    /// <param name="type">授權平台類型</param>
    /// <param name="data">返回的數據</param>
    void OnAuthResultHandler(int reqID, ResponseState state, PlatformType type, Hashtable data)
    {
        if (state == ResponseState.Success)
        {
 　　　　　　 // 授權結果寫入文件
            Utility.WriteFile(Application.persistentDataPath, "AuthData.txt", data.toJson());
            Utility.WriteFile(Application.persistentDataPath, "AuthInfo.txt", ssdk.GetAuthInfo(PlatformType.SinaWeibo).toJson());
            Utility.MakeToast("微博用戶：" + ssdk.GetAuthInfo(PlatformType.SinaWeibo)["userName"] + "\n登錄成功！"); // 信息詳情查看輸入的文件
            ShareSDKManager.Instance.userPlatform = PlatformType.SinaWeibo;
            SceneManager.LoadScene(2);
        }
        else if (state == ResponseState.Fail)
        {
            // 失敗或取消要清除指定平台的授權信息
            ssdk.CancelAuthorize(type);
            Utility.MakeToast("登錄失敗！");
        }
        else if (state == ResponseState.Cancel)
        {
            // 失敗或取消要清除指定平台的授權信息
            ssdk.CancelAuthorize(type);
            Utility.MakeToast("登錄被取消！");
        }
    }
}

寫一個文件讀寫的工具類。

using System.IO;

/// <summary>
/// 讀寫文件的工具類。
/// 用於查看ShareSDK授權時返回的data中有哪些數據。
/// </summary>
public static class Utility
{
    public static void WriteFile(string path, string name, string info)
    {
        StreamWriter writer;
        FileInfo fi = new FileInfo(path + "/" + name);
        writer = fi.CreateText();
        writer.WriteLine(info);
        writer.Close();
        writer.Dispose();
    }
    
    public static string ReadFile(string path, string name)
    {
        StreamReader reader;
        FileInfo fi = new FileInfo(path + "/" + name);
        reader = fi.OpenText();
        string info = reader.ReadToEnd();
        reader.Close();
        reader.Dispose();
        return info;
    }
}

9、打包APK后在安卓模擬器上運行。點擊【用新浪微博登錄】按鈕后即可看到效果：首次登錄時要填微博賬號和密碼，輸入正確后會跳轉到微博授權頁面，點擊確定授權完成后，游戲進入下一個場景，完成操作。再次登錄時直接完成操作，進入下一場景。

打開輸出的兩個dat文件，查看返回的詳細數據。其中用戶ID，用戶名，用戶頭像等是常用的數據。這里為便於自己查看，后綴改成了txt（我用的逍遙游安卓模擬器不讓選擇.dat打開方式）

坑點：

• 如果點擊按鈕沒反應，到微博開放平台測試信息—添加測試帳號，關聯到自己的微博，因為開發者身份認證未通過審核時不能拿到數據。
• 如果點擊按鈕后頁面回退，是Unity中ShareSDK腳本的微博App Key和App Secret沒填對。（有默認的Debug帳號的數據，注意檢查）。
• 報錯“你所訪問的站點在微博認證失敗 錯誤號21322 重定向地址不匹配”。是因為在Unity腳本中沒有填寫回調url，要跟微博開放平台中輸入的回調頁地址一致才行！
• 
• 報錯 21323 ： 請求不合法。該方法登錄如果碰到這個問題，過一段時間后再試試就沒問題了，非常詭異，也許是新浪服務端那邊的問題？？？懷疑是請求過於頻繁導致。沒搞懂這個錯誤。

獲取用戶的帳號詳細信息

接着上面的工程，在用戶詳情頁中寫一個腳本，在已登錄的狀態下獲取微博賬號的詳情。

using cn.sharesdk.unity3d;
using System.Collections;
using UnityEngine;
using UnityEngine.UI;
using UnityEngine.SceneManagement;

public class Info : MonoBehaviour
{
    public Image userIcon;
    public Text userName;
    public Text userID;
    ShareSDK ssdk;

    void Start ()
    {
        ssdk = ShareSDKManager.Instance.ssdk;
        ssdk.showUserHandler = OnGetUserInfoResultHandler;

        // 在前一個場景中已把授權返回的數據寫入到了本地
        Hashtable authInfo = Utility.ReadFile(Application.persistentDataPath, "AuthInfo.dat").hashtableFromJson();
        StartCoroutine(LoadUserIcon(authInfo["userIcon"].ToString()));
        userName.text = authInfo["userName"].ToString();
        userID.text = "ID：" + authInfo["userID"].ToString();
    }

    // 協程下載用戶頭像Icon
    IEnumerator LoadUserIcon(string url)
    {
        WWW www = new WWW(url);
        yield return www; // 等待下載完才執行下面的代碼
        if (www.isDone && www.error == null)
        {
            Texture2D texture2D = www.texture;
            userIcon.sprite = Sprite.Create(texture2D, new Rect(0, 0, texture2D.width, texture2D.height), Vector2.zero);
        }
    }

    // 進入游戲主場景
    public void OnEnterButtonClick()
    {
    }

    // 查看用戶詳細信息
    public void OnDetailButtonClick()
    {
        ssdk.GetUserInfo(PlatformType.SinaWeibo);
    }

    // 獲取用戶詳情的回調
    void OnGetUserInfoResultHandler(int reqID, ResponseState state, PlatformType type, Hashtable data)
    {
        if (state == ResponseState.Success)
        {
            // 將用戶詳情寫入文件中，之后隨意使用。
            Utility.WriteFile(Application.persistentDataPath, "UserInfo.dat", data.toJson());
            // 如獲取用戶位置
            Utility.MakeToast("所在地：" + Utility.Unicode2String(data["location"].ToString()));
        }
        else if (state == ResponseState.Fail)
        {
            Utility.MakeToast("獲取用戶詳情失敗！");
        }
        else if (state == ResponseState.Cancel)
        {
            Utility.MakeToast("獲取用戶詳情被取消！");
        }
    }

    // 注銷，退出登錄
    public void OnSignOutButtonClick()
    {
        // 取消指定平台的授權
        ssdk.CancelAuthorize(PlatformType.SinaWeibo);
        // 回調登錄場景
        SceneManager.LoadScene(1);
    }
}

打開UserInfo.dat查看能獲取到哪些帳號詳情。

獲取好友列表

using cn.sharesdk.unity3d;
using System.Collections;
using UnityEngine;
using UnityEngine.UI;

public class Play : MonoBehaviour
{
    public Text resultText;
    ShareSDK ssdk;

    void Start ()
    {
        ssdk = ShareSDKManager.Instance.ssdk;
        ssdk.getFriendsHandler = OnGetFriendsResultHandler;
    }

    // 點擊獲取好友列表
    public void OnFriendsButtonClick()
    {
        // 分頁獲取當前登錄用戶平台的好友列表，每頁容量，第幾頁（從0開始）
        // 但此接口已被棄用，目前只能准確獲得好友總數，且一次請求只能返回2個好友（第三參數填0返回第1和2位好友），后兩個參數已失效
        // 如果想靠該接口分頁獲取所有好友，需要自行多次獲取，自行分頁
        ssdk.GetFriendList(PlatformType.SinaWeibo, 20, 0);
    }
    
    void OnGetFriendsResultHandler(int reqID, ResponseState state, PlatformType type, Hashtable data)
    {
        if (state == ResponseState.Success)
        {
            // 將好友列表寫入文件中，之后隨意使用。
            Utility.WriteFile(Application.persistentDataPath, "FriendsList.dat", data.toJson());
        }
        else if (state == ResponseState.Fail)
        {
            Utility.MakeToast("獲取好友列表失敗！");
        }
        else if (state == ResponseState.Cancel)
        {
            Utility.MakeToast("獲取好友列表被取消！");
        }
    }
}

查看FriendsList.dat，每個好友的信息有很多數據，同樣中文是Unicode需要轉成String顯示。該接口謹慎使用。

分享功能

void Start ()
{
    ssdk = ShareSDKManager.Instance.ssdk;
    ssdk.shareHandler = OnShareResultHandler;
}

// 點擊分享：截圖，配文字，分享
public void OnShareButtonClick()
{
    // 屏幕截圖，默認存放路徑Application.persistentDataPath，多次調用會同名替換圖片。
    ScreenCapture.CaptureScreenshot("Screenshot.png");
    // 分享的內容
    ShareContent content = new ShareContent();

    // ★通用分享內容的設置
    // 設置分享的文字（正文）
    content.SetText("測試ShareSDK分享功能");

    // 設置分享的圖片
    // SetImagePath：用於本地圖片，參數為圖片路徑
    // SetImageUrl：用於網絡圖片，參數為圖片網址
    // SetImageArray：用於多圖分享，參數為圖片網址string數組。僅支持網絡圖片，僅支持Android。
    content.SetImagePath(Application.persistentDataPath + "/Screenshot.png");

    // 其他可設置的額外參數
    content.SetTitle("ShareSDKDemo");           // 標題
    content.SetTitleUrl("http://www.guxin.me"); // 標題的Url
    content.SetSite("guxin.me");                // 分享來源的站點
    content.SetTitle("http://www.guxin.me");    // 站點的Url
    content.SetUrl("http://www.guxin.me");      // 分享的網站
    content.SetUrlDescription("個人學習ShareSDK的Demo");
    // ...
    // 設定分享內容的主要類型，放在最后一步
    content.SetShareType(ContentType.Image);

    // ★其他平台特異性分享內容的設置
    ShareContent sinaWeiboContent = new ShareContent();
    sinaWeiboContent.SetText(resultText.text + "\n via 新浪微博");
    // 在指定平台上，使用第二個參數中的內容覆蓋主內容里的值
    content.SetShareContentCustomize(PlatformType.SinaWeibo, sinaWeiboContent);

    // ★顯示分享框
    // PlatformType[] platforms = { PlatformType.SinaWeibo, PlatformType.QQ, PlatformType.WeChat };
    // ssdk.ShowPlatformList(platforms, content, 100, 100);
    // 指定顯示平台的方法已棄用，第一個參數穿null即可。
    // string[] platforms = { "5" }; // 查看PlatformType枚舉值，如豆瓣是“5”
    // string[] platforms = { ((int)PlatformType.DouBan).ToString() };
    // 可以設置哪些平台不顯示。
    string[] platforms = { "5", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "20", "25", "26", "27", "28", "29", "30", "34", "35", "36", "38", "39", "40", "41", "42", "43", "44", "45", "46", "47", "50", "51", "52", "53", "54" };
    content.SetHidePlatforms(platforms);

    ssdk.ShowPlatformList(null, content, 100, 100);
}

// 分享結果的回調
void OnShareResultHandler(int reqID, ResponseState state, PlatformType type, Hashtable data)
{
    // 注意：並非所有平台都會報告正確的狀態，如短信、郵件平台，只要界面跳轉成功了都算成功（不管玩家接下來是否真的有點發送）。
    if (state == ResponseState.Success)
    {
        Utility.MakeToast("分享成功！");
        // 游戲中分享成功可能會獲得一些道具，在這里處理。注意不能正確報告的平台，防止玩家未分享也能獲得道具。
        // ......
    }
    else if (state == ResponseState.Fail)
    {
        Utility.MakeToast("分享失敗！");
    }
    else if (state == ResponseState.Cancel)
    {
        Utility.MakeToast("分享被取消！");
    }
}

Bug：指定了分享界面的顯示的可選平台，但還是顯示了所有的平台。即設置指定的分享平台無效。

解決辦法有三種：

一、設置setHidePlatforms，填上所有隱藏的平台，只保留想要的平台。

二、在ShareSDK腳本上把不需要的平台的Enable取消勾選，直接關閉與該平台的所有交互。

三、在Plugins-Android-lib里刪除不需要的平台的包（ShareSDK開頭的lib文件）

建議使用方法一，可適應如不同界面要顯示不同的分享平台等需求。

---

導入SMSSDK報錯，包沖突問題

1、登錄mob.com后台，給應用添加SMSSDK功能。並從官網 下載短信驗證碼SDK（https://github.com/MobClub/SMSSDK-for-Unity3D），內含詳細文檔。

2、將SMSSDK.unitypackage導入項目中。會報錯MiniJSON已存在，這是因為已同時存在Assets/Plugins/SMSSDK/MiniJSON.cs和Assets/Plugins/ShareSDK/MiniJSON.cs文件（名稱空間相同），刪掉一個即可，如刪掉SMSSDK文件夾下的。

3、打包運行，發現報錯，AndroidManifest清單文件無法合並等問題。這是因為Assets/Plugins/Android/ShareSDK/lib和Assets/Plugins/Android/SMSSDK/lib文件夾下有相同的MobCommons.lib和MobTools.lib，包沖突了（雖然后邊版本號不同）。任意刪除一邊的兩個包即可，如刪除SMSSDK文件夾下的。把兩個清單的都設置 android:minSdkVersion="16" , android:targetSdkVersion="26"

AndroidManifest清單合並報錯。

F:\workspace\Unity Learning\ShareSDKDemo\Temp\StagingArea\AndroidManifest-main.xml:28:13-74 Error:
    Attribute activity#com.mob.tools.MobUIShell@configChanges value=(keyboardHidden|orientation|screenSize) from AndroidManifest.xml:28:13-74
    is also present at AndroidManifest.xml:15:13-97 value=(keyboardHidden|orientation|screenSize|locale|layoutDirection).
    Suggestion: add 'tools:replace="android:configChanges"' to <activity> element at AndroidManifest-main.xml:26:9-44:20 to override.
F:\workspace\Unity Learning\ShareSDKDemo\Temp\StagingArea\AndroidManifest-main.xml:29:13-72 Error:
    Attribute activity#com.mob.tools.MobUIShell@theme value=(@android:style/Theme.Translucent.NoTitleBar) from AndroidManifest.xml:29:13-72
    is also present at AndroidManifest.xml:16:13-60 value=(@android:style/Theme.NoTitleBar).
    Suggestion: add 'tools:replace="android:theme"' to <activity> element at AndroidManifest-main.xml:26:9-44:20 to override.

UnityEngine.GUIUtility:ProcessEvent(Int32, IntPtr)

這是因為在 Assets/Plugins/Android/ShareSDK/AndroidManifest.xml與Assets/Plugins/Android/SMSSDKGUI/AndroidManifest.xml中有重復設置android:configChanges和android:theme屬性。去掉SMSSDKGUI/AndroidManifest.xml中的該屬性即可。

短信登錄

SMSSDK主要使用發驗證碼、收驗證碼、比對驗證碼功能，其他功能已多年未維護，不推薦使用。

官網文檔 http://wiki.mob.com/smssdk-android-for-unity3d/

在Init場景中給物體掛上SMSSDK腳本，該腳本已默認填有App Key和App Secret。雖然已在mob后台添加了SMSSDK功能，但測試時依然可以繼續用該Debug帳號，因為不受每天20條短信限制。（發布時再改用自己的Key和Secret，上線后不受數量限制，且可定制短信）

在自定義的管理類中初始化smssdk。

// SMSSDK初始化
smssdk = gameObject.GetComponent<SMSSDK>();
smssdk.init("moba6b6c6d6", "b89d2427a3bc7ad1aea1e1e8c1d36bf3", true); // 用默認的Debug帳號的App Key和App Secret測試。上線時改用在mob后台給的值。

主邏輯腳本繼承SMSSDKHandler接口，實現onComplete()和onError()這兩個回調函數，smssdk.setHandler()注冊。注意枚舉ActionType.SubmitUserInfo和ActionType.GetFriends已很久未維護，不推薦使用。

最終整合了微博登錄與短信登錄的腳本如下。

using cn.sharesdk.unity3d;
using cn.SMSSDK.Unity;
using System.Collections;
using UnityEngine;
using UnityEngine.SceneManagement;

public class Login : MonoBehaviour, SMSSDKHandler
{
    ShareSDK ssdk;
    SMSSDK smssdk;

    void Start () {
        ssdk = ShareSDKManager.Instance.ssdk;
        ssdk.authHandler = OnAuthResultHandler; // 授權結果的回調函數

        smssdk = ShareSDKManager.Instance.smssdk;
        smssdk.setHandler(this); // 短信操作的回調
    }
    
    // 用新浪微博登錄
    public void OnSinaLoginButtonClick()
    {
        if (ssdk.IsAuthorized(PlatformType.SinaWeibo)) // 檢測指定的平台是否已經授權過了
        {
            // 寫入授權信息
            Utility.WriteFile(Application.persistentDataPath, "AuthInfo.txt", ssdk.GetAuthInfo(PlatformType.SinaWeibo).toJson());
            Utility.MakeToast("微博用戶：" + ssdk.GetAuthInfo(PlatformType.SinaWeibo)["userName"] + "\n登錄成功！"); // 信息詳情查看輸入的文件
            ShareSDKManager.Instance.userPlatform = PlatformType.SinaWeibo;
            SceneManager.LoadScene(2);
        }
        else // 指定的平台尚未授權，給它授權
        {
            ssdk.Authorize(PlatformType.SinaWeibo);
        }
    }

    /// <summary>
    /// 授權結果的回調函數
    /// </summary>
    /// <param name="reqID"></param>
    /// <param name="state">授權狀態：成功，失敗，取消</param>
    /// <param name="type">授權平台類型</param>
    /// <param name="data">返回的數據</param>
    void OnAuthResultHandler(int reqID, ResponseState state, PlatformType type, Hashtable data)
    {
        if (state == ResponseState.Success)
        {
            // 授權結果寫入文件
            Utility.WriteFile(Application.persistentDataPath, "AuthData.txt", data.toJson());
            Utility.WriteFile(Application.persistentDataPath, "AuthInfo.txt", ssdk.GetAuthInfo(PlatformType.SinaWeibo).toJson());
            Utility.MakeToast("微博用戶：" + ssdk.GetAuthInfo(PlatformType.SinaWeibo)["userName"] + "\n登錄成功！"); // 信息詳情查看輸入的文件
            ShareSDKManager.Instance.userPlatform = PlatformType.SinaWeibo;
            SceneManager.LoadScene(2);
        }
        else if (state == ResponseState.Fail)
        {
            // 失敗或取消要清除指定平台的授權信息
            ssdk.CancelAuthorize(type);
            Utility.MakeToast("登錄失敗！");
        }
        else if (state == ResponseState.Cancel)
        {
            // 失敗或取消要清除指定平台的授權信息
            ssdk.CancelAuthorize(type);
            Utility.MakeToast("登錄被取消！");
        }
    }

    // 用短信登錄，有兩種方式
    public void OnSmsButtonClick()
    {
        // 方式一：非UI方式，需要搭配Unity里自己制作的UI
        /*
         * 通過getCode()獲得驗證碼，參數是：驗證碼類型（短信/語音），手機號，國際區域號（大陸為86，非國內電話的區號），模板號
         * smssdk.getCode(CodeType, phone, zone, tempCode);
         * 通過commitCode()方式提交驗證碼，參數：手機號，國際區域號（大陸為86，非國內電話的區號），驗證碼
         * smssdk.commitCode(phone, zone, code);
         */

        // 方式二：UI方式，直接使用SMSSDK自帶的UI（Android下的界面）
        smssdk.showRegisterPage(CodeType.TextCode, null); //tempcode是模板編號，如還未申請傳null即可。申請新模板要等審核通過。
    }


    // 短信操作，完成
    public void onComplete(int action, object resp)
    {
        ActionType act = (ActionType)action;
        //Debug.Log(act);
        if (act == ActionType.CommitCode)
        {
            ShareSDKManager.Instance.userPlatform = PlatformType.SMS;
            ShareSDKManager.Instance.userID = ((string)resp).hashtableFromJson()["phone"].ToString();
            Utility.MakeToast("手機用戶：" + ShareSDKManager.Instance.userID + "\n登錄成功！");
            SceneManager.LoadScene(2);
        }
    }

    // 短信操作，失敗
    public void onError(int action, object resp)
    {
        Utility.MakeToast("短信驗證失敗！");
    }
}

---

自用Demo：https://gitee.com/guxin233/Unity_ShareSDK_Demo