【Unity遊戲開發】不接SDK也能在遊戲內拉起加QQ群操作？

馬三小夥兒發表於2019-07-28

一、引子

　　一般在遊戲進行對外測試的時候都會有一個玩家QQ群，方便玩家反饋問題、交流遊戲心得等。那麼為了增加玩家加QQ群的慾望，可能會在遊戲裡面設計一個小功能，點選一下可以直接拉起手Q加群的操作，加了QQ群以後，也會自動下發一些小獎勵刺激玩家。原本我以為要拉起手Q加QQ群的操作一定要接入相關平臺的SDK才行，直到我詳細地閱讀了下騰訊官網的QQ群官方主頁，我才瞭解到在遊戲內拉起手Q發起加群的操作是如此的簡單，根本不需要接入任何第三方SDK，只需短短几行程式碼即可輕鬆實現。閒言少敘，書歸正文，我們們馬上就開始實際操作一下。

二、解決方案

1.Android端的工作

　　在騰訊官網的QQ群官方主頁，我們可以直接看到官方已經為我們提供好了Android相關的程式碼，直接複製出來並整合到我們遊戲專案對應的Android工程中就可以使用了。如果是使用Internal打包方式的話，可以在Eclispe編寫Java的相關程式碼，然後打成jar包供Unity端呼叫。如果是使用Gradle方式的話，可以在專案匯出AndroidStudio工程的過程中，自動化新增進這一段程式碼。關於使用Gradle方式進行非侵入式SDK接入打包，馬三有在工作中有了一些新的心得體會，會在以後部落格中講解一下。（媽的這小子又挖坑，不會過段時間又太監了吧）

　　^{圖1：QQ群官網Android端程式碼}

　　在你的Java程式碼中新增以下程式碼即可，key不要寫死在Java程式碼中，最好由Unity呼叫端傳入：

 1 /****************
 2      *
 3      * 發起新增群流程。群號：ColaFramework交流群(421527940) 的 key 為： xxxxxxxxx
 4      * 呼叫 joinQQGroup(xxxxxxxxx) 即可發起手Q客戶端申請加群 ColaFramework交流群(421527940)
 5      *
 6      * @param key 由官網生成的key
 7      * @return 返回true表示呼起手Q成功，返回fals表示呼起失敗
 8      ******************/
 9     public boolean joinQQGroup(String key) {
10         Intent intent = new Intent();
11         intent.setData(Uri.parse("mqqopensdkapi://bizAgent/qm/qr?url=http%3A%2F%2Fqm.qq.com%2Fcgi-bin%2Fqm%2Fqr%3Ffrom%3Dapp%26p%3Dandroid%26k%3D" + key));
12         // 此Flag可根據具體產品需要自定義，如設定，則在加群介面按返回，返回手Q主介面，不設定，按返回會返回到呼起產品介面    //intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
13         try {
14             startActivity(intent);
15             return true;
16         } catch (Exception e) {
17             // 未安裝手Q或安裝的版本不支援
18             return false;
19         }
20     }

　　至此我們Android端所需要做的工作就完成了，是不是超級方便哈~幾乎啥也沒幹，蛤蛤。　　

2.iOS端的工作

　　再來看看我們需要在iOS端做些什麼？其實跟Android端的工作大同小異，主要還是提供一個介面給Unity端呼叫。在騰訊官網的QQ群官方主頁，官方也同樣為我們提供好了iOS相關的程式碼，不過這些程式碼要在Unity上使用的話，還需要小小地改造和封裝一下。輕輕點亮一個贊，我們們下面馬上就現場教學，教大家怎麼處理一下：

　　^{圖2：QQ群官網 iOS端程式碼}

　　在Unity工程對應的iOS工程中的UnityAppController.mm中新增以下的程式碼就可以了。相較於Android，iOS上面還需要多傳入一個uid引數。而且Unity端這邊傳過來的是const char *型別的字串指標，我們需要將其轉換成 NSString 以便供API呼叫。

 1     extern "C" BOOL iOSJoinQQGroup(const char* rawKey,const char* rawUid){
 2         NSString * key = [NSString stringWithUTF8String:rawKey];
 3         NSString * uid = [NSString stringWithUTF8String:rawUid];
 4         NSString *urlStr = [NSString stringWithFormat:@"mqqapi://card/show_pslcard?src_type=internal&version=1&uin=%@&key=%@&card_type=group&source=external", uid,key];
 5         NSURL *url = [NSURL URLWithString:urlStr];
 6         if([[UIApplication sharedApplication] canOpenURL:url]){
 7         [[UIApplication sharedApplication] openURL:url];
 8             return YES;
 9         }
10     else return NO;
11     }

　　至此，我們在iOS端需要做的工作也完成了，下一步就是在Unity中去呼叫這些介面了。

3.Unity端的工作

　　簡單地搭建一個模擬遊戲中加群的介面，有一個二維碼和一鍵加群按鈕，我們期待的是玩家在遊戲裡面點選按鈕就可以直接加入QQ群。

　　^{圖3：遊戲介面示意圖}

　　對應的C#程式碼如下，就是一些簡單的封裝與Unity和Android、iOS端通訊互動的基本操作，如果對這塊不太瞭解的話，可以看馬三之前的部落格《【Unity遊戲開發】SDK接入與整合——小白入門篇》。值得注意的是，我們需要處理好不同平臺下呼叫的問題，加入必要的平臺巨集判斷，在Unity編輯器下執行的這種情況也要考慮進去。

 1 using System.Collections;
 2 using System.Collections.Generic;
 3 using System.Runtime.InteropServices;
 4 using UnityEngine;
 5 using UnityEngine.UI;
 6 
 7 public class MyScript : MonoBehaviour
 8 {
 9 
10     private static readonly string AndroidKey = "YouAndroidQQGroupKey";
11 
12     private static readonly string iOSUid = "YouiOSUid";
13     private static readonly string iOSKey = "YouiOSQQGroupKey";
14 
15     private AndroidJavaClass _jc;
16     private AndroidJavaObject _jo;
17 
18     // Use this for initialization
19     void Start()
20     {
21         _jc = new AndroidJavaClass("com.unity3d.player.UnityPlayer");
22         _jo = _jc.GetStatic<AndroidJavaObject>("currentActivity");
23 
24         var btnObj = this.transform.Find("BtnQQ");
25         var button = btnObj.GetComponent<Button>();
26         button.onClick.AddListener(OnClick);
27     }
28 
29     private void OnClick()
30     {
31         bool result = JoinQQGroup();
32         if (result)
33         {
34             //TODO 你的業務邏輯
35         }
36         else
37         {
38             Debug.LogWarning("未安裝手Q或者版本不支援！");
39         }
40     }
41 
42     /// <summary>
43     /// 加入QQ群的方法，有返回值，代表成功或者失敗
44     /// </summary>
45     /// <returns></returns>
46     private bool JoinQQGroup()
47     {
48 #if !UNITY_EDITOR && UNITY_ANDROID
49         return CallAndroidMethod<bool>("joinQQGroup", AndroidKey);
50 #elif !UNITY_EIDTOR && UNITY_IOS
51         return iOSJoinQQGroup(iOSKey, iOSUid);
52 #else
53         return false;
54 #endif
55     }
56 
57     /// <summary>
58     /// 呼叫一個帶有返回值的原生Android方法
59     /// </summary>
60     /// <typeparam name="ReturnType"></typeparam>
61     /// <param name="method"></param>
62     /// <param name="args"></param>
63     /// <returns></returns>
64     private ReturnType CallAndroidMethod<ReturnType>(string method, params object[] args)
65     {
66 #if !UNITY_EDITOR && UNITY_ANDROID
67         return _jo.Call<ReturnType>(method, args);
68 #endif
69         return default(ReturnType);
70     }
71 
72     //iOS方法匯入
73 #if !UNITY_EDITOR && UNITY_IOS
74     [DllImport("__Internal")]
75     private static extern bool iOSJoinQQGroup(string key, string uid);
76 #endif
77 
78 }