Wiki.ssl.msdk.qq.com
MSDK 3.3.0更新指引接口变更删除接口WGBindQQGroupWGJoinQQGroupWGQueryQQGroupInfoWGUnbindQQGroupWGQueryQQGroupKey参数变更WGSendToQQWithRichPhotoWGSendToWeixinWGSendToWeixinWithUrlWGSendToWeixinWithVideoWGSendToWXWithMiniApp新增接口WGRegisterAPNSPushNotification (仅iOS)WGSuccessedRegisterdAPNSWithToken (仅iOS)WGFailedRegisteredAPNS (仅iOS)WGCleanBadgeNumber (仅iOS)WGReceivedMSGFromAPNS (仅iOS)WGSendToQQWithRichPhoto(仅iOS)WGLaunchMiniAppWGSendToQQWithTextWGOpenEmbeddedWebViewWGCloseEmbeddedWebViewWGCallToEmbeddedWebViewWGSetEmbeddedWebViewBackground废弃接口WGSendToWXGameFriendv2.1x升级到v3.x方案1包结构说明1. MSDK的发布包(zip)主要包含两个重要部分MSDKLibrary和MSDKDemo,前者为MSDK库,后者MSDK接口的使用示例2. (若游戏只使用Java接口可不关注此项)MSDKC11So,MSDKC99So分别是在C11,C99环境下编译的MSDK的libMSDKSystem.so(MSDK核心so库)。MSDKLibrary中默认是使用C11的so库,如果游戏没有特别指定c++版本,则默认是使用C11编译,直接使用MSDKLibrary即可。 一般在Android.mk在指定的方式如下:LOCAL_CFLAGS := -std=c99LOCAL_CFLAGS := -std=c++11(如果不指定则默认是此项)3. MSDKDemo_Buildxxx_3.0.0a_xxx_test.apk是MSDKDemo的apk包,供游戏体验使用4. build.gradle, settings.gradle是用来支持游戏使用Android Studio打开MSDK的示例工程,游戏也可直接用Eclipse直接import MSDKDemo,MSDKLibrary来打开示例工程5. MSDKLibrary/jni/WGPlatform.h中包含了所有的接口说明(java与C++的接口是对应的)2升级说明2.1 代码文件更新2.1.1使用Java接口游戏对于只使用Java接口的游戏,游戏只需更新so,jar包,配置文件,资源文件等即可。下面是so, jar包更新方法。1)复制(如重复则替换)MSDKLibrary的libs目录下的so,及jar包到游戏相应目录。其中so库相对于v2.1x的版本多了libMSDKSystem.so,libBugly.so替换为libBugly-msdk.so。2.1.2使用C++接口游戏MSDK V3版本不再提供源码给游戏编成so,而是将MSDK相关C++源码编为libMSDKSystem.so供游戏使用,避免源码被误操作发生异常。下面介绍从V2.1x升级到V3更新方法。1)按照2.1.1的说明更新jar包和so文件。2)删除v2.1x提供的msdk相关c++源码文件(.cpp .h),如图3)引用或复制MSDKLibrary/jni目录下的头文件到游戏相应目录,游戏调用MSDK接口时只#include “WGPlatform.h”即可4)修改Android.mk链接MSDK的核心so库,并引入MSDK头文件,参考:# 引入MSDK头文件,以下目录可改成游戏相应目录LOCAL_C_INCLUDES += $(LOCAL_PATH)/../../MSDKLibrary/jni# 链接MSDK核心库,以下目录可改成游戏相应目录LOCAL_LDLIBS += -L$(LOCAL_PATH)/../../MSDKLibrary/libs/$(TARGET_ARCH_ABI) -lMSDKSystem-L$(LOCAL_PATH)/../../MSDKLibrary/libs/$(TARGET_ARCH_ABI) :将libMSDKSystem.so库所在的目录设为so库的链接路径。($(TARGET_ARCH_ABI) :表示游戏需要编绎的cpu abi,如armeabi-v7a, x86等目录)。-lMSDKSystem :表示链接libMSDKSystem.so库5)在Java层加载游戏so前先加载libMSDKSystemo.so(因为游戏需要调用MSDK接口,因此游戏依赖MSDK so,libMSDKSystemo.so需要先加载)。参考:public class MainActivity extends Activity { static { System.loadLibrary("MSDKSystem"); // MSDK核心so库 System.loadLibrary("WeGameSample"); // MSDKDemo的so库,类似于游戏so库 }}2.2资源文件更新2.2.1MSDK资源及配置文件更新1)复制(如重复则替换)MSDKLibrary中res目录到游戏相应目录。2)复制MSDKDemo中assets目录中的cert文件夹(https证书)、msdk_agreement.txt(实名同意协议)、msdkconfig.ini(MSDK开关配置文件)到游戏工程的相应目录(assets)。如果游戏已经存在assets/msdkconfig.ini文件,则无需替换。备注:1、从3.2.6版本开始已不再需要msdk_agreement.txt2、从3.2.6版本到3.2.17版本开始已不再需要cert文件夹3)若游戏原为2.16.0以下版本,需要升级配置文件msdkconfig.ini中域名配置方式变更,可参考MSDKDemo/assets/msdkconfig.ini,具体变动如下:#删除旧配置MSDK_URL=增加新配置(test测试环境,release正式环境)MSDK_ENV=test2.2.2配置文件AndroidManifest.xml变更1)增加权限声明<!-- 读取sdcard权限 --><uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> 2)增加两个MSDK相关Activity声明<!-- 兼容6.0及以上系统权限--><activity android:name="com.tencent.msdk.PermissionActivity" android:excludeFromRecents="true" android:exported="true" android:label="PermissionActivity" android:launchMode="singleTop" android:theme="@android:style/Theme.Translucent.NoTitleBar" android:screenOrientation="behind" android:taskAffinity="com.example.wegame.diff" ></activity><!-- msdk httpdns网络监听 --><receiverandroid:name="com.tencent.special.httpdns.Cache$ConnectReceiver" android:label="NetworkConnection" > <intent-filter> <action android:name=".conn.CONNECTIVITY_CHANGE"/> </intent-filter></receiver>3)3.0.8a及以上版本升级信鸽版本至3.1,注意使用下面的信鸽配置,替换原有的信鸽配置:<!-- 信鸽配置START --><!-- 【必须】 (2.30及以上版新增)展示通知的activity --><activityandroid:name="com.tencent.android.tpush.XGPushActivity"android:theme="@android:style/Theme.Translucent"android:exported="false" ><intent-filter><!-- 若使用AndroidStudio,请设置android:name="android.intent.action",否则如下设置--><action android:name="" /></intent-filter></activity><!-- 【必须】 信鸽receiver广播接收 --><receiverandroid:name="com.tencent.android.tpush.XGPushReceiver"android:process=":xg_service_v3" ><intent-filter android:priority="0x7fffffff" ><!-- 【必须】 信鸽SDK的内部广播 --><action android:name="com.tencent.android.tpush.action.SDK" /><action android:name="com.tencent.android.tpush.action.INTERNAL_PUSH_MESSAGE" /><!-- 【必须】 系统广播:网络切换 --><action android:name=".conn.CONNECTIVITY_CHANGE" /><!-- 【可选】 系统广播:开屏 --><action android:name="android.intent.action.USER_PRESENT" /><!-- 【可选】 一些常用的系统广播,增强信鸽service的复活机会,请根据需要选择。 --><action android:name="android.bluetooth.adapter.action.STATE_CHANGED" /><action android:name="android.intent.action.ACTION_POWER_CONNECTED" /><action android:name="android.intent.action.ACTION_POWER_DISCONNECTED" /></intent-filter><!-- 【可选】 usb相关的系统广播,增强信鸽service的复活机会,请根据需要添加 --><intent-filter android:priority="0x7fffffff" ><action android:name="android.intent.action.MEDIA_UNMOUNTED" /><action android:name="android.intent.action.MEDIA_REMOVED" /><action android:name="android.intent.action.MEDIA_CHECKING" /><action android:name="android.intent.action.MEDIA_EJECT" /><data android:scheme="file" /></intent-filter></receiver><!-- 【必须】 信鸽service --><serviceandroid:name="com.tencent.android.tpush.service.XGPushServiceV3"android:exported="true"android:persistent="true"android:process=":xg_service_v3" /><!-- 【必须】 【注意】authorities修改为 包名.AUTH_XGPUSH, 如demo的包名为:com.example.wegame--><providerandroid:name="com.tencent.android.tpush.XGPushProvider"android:authorities="com.example.wegame.AUTH_XGPUSH"android:exported="true"/><!-- 【必须】 【注意】authorities修改为 包名.TPUSH_PROVIDER, 如demo的包名为:com.example.wegame--><providerandroid:name="com.tencent.android.tpush.SettingsContentProvider"android:authorities="com.example.wegame.TPUSH_PROVIDER"android:exported="false" /><!-- 【必须】 【注意】authorities修改为 包名.TENCENT.MID.V3, 如demo的包名为:com.example.wegame--><providerandroid:name="com.tencent.mid.api.MidProvider"android:authorities="com.example.wegame.TENCENT.MID.V3"android:exported="true" ></provider>4)建议游戏的启动Activity launchMode设置为singleTask,如<!-- TODO MSDKDemo配置 START --><activity android:name="com.example.wegame.MainActivity" android:configChanges="orientation|screenSize|keyboardHidden" android:screenOrientation="sensor" android:launchMode="singleTask"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity><!-- TODO MSDKDemo配置 END -->详细说明:如果设置为singleTop,则游戏需要在启动Activity添加去重代码。以避免在有其他Activity覆盖在游戏Activity时,其他App拉起游戏而导致拉起重复的游戏Activity问题。如果设置为singleTask,可避免拉起重复游戏实例问题。这样设置会有个特点,如果游戏之上有其他Activity,此时切换到后台,再点游戏回到前台会销毁此Activity而直接呈现游戏Activity。综合评估,建议游戏侧设置为singleTask。2.3接口变更Android版本V3接口相对于2.18.1,为了和iOS接口保持一致,有4个接口参数类型有变更,有一个接口删除。如果使用到以下接口请注意修改,以防止编译报错:1.OnCrashExtDataNotify()的返回值类型由原来的char* 类型变为 std::vector类型2.接口参数类型由string改为unsigned char *,以保持双端一致:WGSetPushTag(string tag) WGSetPushTag(unsigned char *tag)WGDeletePushTag(string tag) WGDeletePushTag(unsigned char *tag)WGGetNoticeData(string scene) WGGetNoticeData(unsigned char *scene)3.去掉WGFeedback中带两个参数的接口,保留带一个参数的接口。主要是为了优化游戏侧调用,及使用游戏名做关键字进行查询时默认使用飞鹰上的游戏名,避免游戏自己传递游戏名造成混淆:int WGFeedback(unsigned char *game, unsigned char *txt);void WGFeedback(unsigned char *body);注意:C++的WGSetObserver等设置回调接口,必须要在Java的WGPlatform.Initialized()初始化MSDK后调用,否则会无效。V3版本加强了对登录态的校验,游戏启动后,需要调用WGLogin(ePlatform_None)进行自动登录,以确保登录态有效,否则可能会出现分享无权限等问题。2.4 v3.2.5手Q v2群接口新的群接口参考: HYPERLINK "; v3.2.5 腾讯视频vip启动特权腾讯视频启动特权接入说明:android:需要在AndroidManifest中添加以下配置<activityandroid:name="com.tencent.msdk.SchemeActivity"android:launchMode="singleTask">iOS:需要在plist中加入配置项:Identifier:tencentvideoURL Schemes:tencentlaunch100703379Role:Editor ................
................
In order to avoid copyright disputes, this page is only a partial summary.
To fulfill the demand for quickly locating and searching documents.
It is intelligent file search solution for home and business.