【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 }

  

  圖4:在編輯器下呼叫的結果

  Android和iOS的效果馬三就不單獨打包展示了,感興趣的話,大家可以自己打包測試一下。

三、總結

  在本篇部落格中,馬三和大家一起學習瞭如何實現在不接SDK的情況在手機上拉起手Q加群。在開發工作中,有些問題可能並沒有我們想象中的那麼複雜,進行功能開發之前多閱讀一下官方文件、收集下相關資料,說不定就會有更加簡單優雅的解決方案。

 

 

 

 

如果覺得本篇部落格對您有幫助,可以掃碼小小地鼓勵下馬三,馬三會寫出更多的好文章,支援微信和支付寶喲!

       

 

作者:馬三小夥兒
出處:https://www.cnblogs.com/msxh/p/11243588.html 
請尊重別人的勞動成果,讓分享成為一種美德,歡迎轉載。另外,文章在表述和程式碼方面如有不妥之處,歡迎批評指正。留下你的腳印,歡迎評論!

相關文章