com.xd.sdk.common 7.2.1-alpha.2 → 7.2.1-alpha.4

package/Plugins/iOS/XDTapSDK4WrapperSDK.framework/Headers/XDGTapTapAchievementWrapper.h.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: 51f07f082b24844499ad4befed052a03
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Plugins/iOS/XDTapSDK4WrapperSDK.framework/Headers/XDGTapTapCloudSaveCallback.h

@@ -0,0 +1,90 @@
+//
+//  XDGTapTapCloudSaveCallback.h
+//  XDTapSDK4WrapperSDK
+//
+//  Created by Fattycat on 2025/12/3.
+//
+
+
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/// 存档数据模型
+@interface XDGArchiveData : NSObject
+
+@property (nonatomic, copy) NSString *uuid;
+@property (nonatomic, copy) NSString *name;
+@property (nonatomic, copy) NSString *summary;
+@property (nonatomic, copy) NSString *extra;
+@property (nonatomic, assign) int64_t playtime;
+@property (nonatomic, assign) int64_t saveSize;
+@property (nonatomic, assign) int64_t coverSize;
+@property (nonatomic, copy) NSString *fileId;
+@property (nonatomic, assign) int64_t createdTime;
+@property (nonatomic, assign) int64_t modifiedTime;
+
+@end
+
+/// 存档元数据
+@interface XDGArchiveMetadata : NSObject
+
+@property (nonatomic, copy) NSString *name;
+@property (nonatomic, copy) NSString *summary;
+@property (nonatomic, copy) NSString *extra;
+@property (nonatomic, assign) int64_t playtime;
+
+@end
+
+/// 云存档状态回调协议
+@protocol XDGTapTapCloudSaveCallback <NSObject>
+
+@required
+
+/// CloudSave 结果通知
+/// @param resultCode 结果代码
+- (void)onResult:(NSInteger)resultCode;
+
+@end
+
+/// 云存档请求回调协议
+@protocol XDGTapTapCloudSaveRequestCallback <NSObject>
+
+@required
+
+/// 存档创建成功
+/// @param archive 存档数据
+- (void)onArchiveCreatedWithArchive:(XDGArchiveData *)archive;
+
+/// 存档更新成功
+/// @param archive 存档数据
+- (void)onArchiveUpdatedWithArchive:(XDGArchiveData *)archive;
+
+/// 存档删除成功
+/// @param archive 存档数据
+- (void)onArchiveDeletedWithArchive:(XDGArchiveData *)archive;
+
+/// 存档列表结果
+/// @param archives 存档列表
+- (void)onArchiveListResultWithArchives:(NSArray<XDGArchiveData *> *)archives;
+
+/// 存档数据结果
+/// @param archiveUUID 存档 UUID
+/// @param archiveFileID 存档文件 ID
+/// @param data 数据
+- (void)onArchiveDataResultWithArchiveUUID:(NSString *)archiveUUID archiveFileID:(NSString *)archiveFileID data:(NSData *)data;
+
+/// 存档封面结果
+/// @param archiveUUID 存档 UUID
+/// @param archiveFileID 存档文件 ID
+/// @param coverData 封面数据
+- (void)onArchiveCoverResultWithArchiveUUID:(NSString *)archiveUUID archiveFileID:(NSString *)archiveFileID coverData:(NSData *)coverData;
+
+/// 请求错误
+/// @param errorCode 错误码
+/// @param errorMessage 错误信息
+- (void)onRequestErrorWithErrorCode:(NSInteger)errorCode errorMessage:(NSString *)errorMessage;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/Plugins/iOS/XDTapSDK4WrapperSDK.framework/Headers/XDGTapTapCloudSaveCallback.h.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: a0d3f11d8c0504863b5ae0cb0dd83fee
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Plugins/iOS/XDTapSDK4WrapperSDK.framework/Headers/XDGTapTapCloudSaveWrapper.h

@@ -0,0 +1,74 @@
+//
+//  XDGTapTapCloudSaveWrapper.h
+//  XDTapSDK4WrapperSDK
+//
+//  Created by Fattycat on 2025/12/3.
+//
+
+#import <Foundation/Foundation.h>
+#import <XDTapSDK4WrapperSDK/XDGTapTapCloudSaveCallback.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/// TapTap 云存档封装类
+@interface XDGTapTapCloudSaveWrapper : NSObject
+
+/// 注册 CloudSave 回调
+/// @param callback 回调对象
++ (void)registerCloudSaveCallback:(id <XDGTapTapCloudSaveCallback> _Nonnull)callback;
+
+/// 取消注册 CloudSave 回调
+/// @param callback 回调对象
++ (void)unregisterCloudSaveCallback:(id <XDGTapTapCloudSaveCallback> _Nonnull)callback;
+
+/// 创建存档
+/// @param archiveMetadata 存档元数据
+/// @param archiveFilePath 存档文件路径
+/// @param archiveCoverPath 存档封面路径
+/// @param callback 回调
++ (void)createArchiveWithArchiveMetadata:(XDGArchiveMetadata * _Nonnull)archiveMetadata
+                         archiveFilePath:(NSString * _Nonnull)archiveFilePath
+                        archiveCoverPath:(NSString * _Nullable)archiveCoverPath
+                                callback:(id <XDGTapTapCloudSaveRequestCallback> _Nonnull)callback;
+
+/// 更新存档
+/// @param archiveUUID 存档 UUID
+/// @param archiveMetadata 存档元数据
+/// @param archiveFilePath 存档文件路径
+/// @param archiveCoverPath 存档封面路径
+/// @param callback 回调
++ (void)updateArchiveWithArchiveUUID:(NSString * _Nonnull)archiveUUID
+                     archiveMetadata:(XDGArchiveMetadata * _Nonnull)archiveMetadata
+                     archiveFilePath:(NSString * _Nonnull)archiveFilePath
+                    archiveCoverPath:(NSString * _Nullable)archiveCoverPath
+                            callback:(id <XDGTapTapCloudSaveRequestCallback> _Nonnull)callback;
+
+/// 删除存档
+/// @param archiveUUID 存档 UUID
+/// @param callback 回调
++ (void)deleteArchiveWithArchiveUUID:(NSString * _Nonnull)archiveUUID
+                            callback:(id <XDGTapTapCloudSaveRequestCallback> _Nonnull)callback;
+
+/// 获取存档列表
+/// @param callback 回调
++ (void)getArchiveListWithCallback:(id <XDGTapTapCloudSaveRequestCallback> _Nonnull)callback;
+
+/// 获取存档数据
+/// @param archiveUUID 存档 UUID
+/// @param archiveFileID 存档文件 ID
+/// @param callback 回调
++ (void)getArchiveDataWithArchiveUUID:(NSString * _Nonnull)archiveUUID
+                        archiveFileID:(NSString * _Nonnull)archiveFileID
+                             callback:(id <XDGTapTapCloudSaveRequestCallback> _Nonnull)callback;
+
+/// 获取存档封面
+/// @param archiveUUID 存档 UUID
+/// @param archiveFileID 存档文件 ID
+/// @param callback 回调
++ (void)getArchiveCoverWithArchiveUUID:(NSString * _Nonnull)archiveUUID
+                         archiveFileID:(NSString * _Nonnull)archiveFileID
+                              callback:(id <XDGTapTapCloudSaveRequestCallback> _Nonnull)callback;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/Plugins/iOS/XDTapSDK4WrapperSDK.framework/Headers/XDGTapTapCloudSaveWrapper.h.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: 486d7db17e2714320b40dde2a8ced632
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Plugins/iOS/XDTapSDK4WrapperSDK.framework/Headers/XDGTapTapMomentDelegate.h

@@ -0,0 +1,77 @@
+//
+//  XDGTapTapMomentDelegate.h
+//  XDTapSDK4WrapperSDK
+//
+//  Created by Fattycat on 2025/12/3.
+//
+
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/// TapTap 动态回调代理
+@protocol XDGTapTapMomentDelegate <NSObject>
+
+@optional
+
+/// 动态回调
+/// @param code 回调码
+/// @param msg 回调消息
+- (void)onMomentCallbackWithCode:(NSInteger)code msg:(NSString * _Nullable)msg;
+
+@end
+
+/// TapTap 动态发布数据基类
+@interface XDGTapTapMomentPostData : NSObject
+
+@end
+
+/// TapTap 动态视频数据
+@interface XDGTapTapMomentVideoData : XDGTapTapMomentPostData
+
+/**
+ @brief 图片本地路径（可选）
+ @warning 数组最多可存一个，超出部分截选第一个
+ */
+@property (nonatomic, copy, nullable) NSArray<NSString *> *images;
+
+/**
+@brief 视频本地路径（可选）
+@warning 数组最多可存一个，超出部分截选第一个
+*/
+@property (nonatomic, copy, nullable) NSArray<NSString *> *videos;
+
+/**
+@brief 标题（可选）
+@warning 文字长度限制为40，超过40取前40
+*/
+@property (nonatomic, copy, nullable) NSString *title;
+
+/**
+@brief 文字内容（可选）
+@warning 文字长度限制为40，超过40取前40
+*/
+@property (nonatomic, copy, nullable) NSString *content;
+
+@end
+
+/// TapTap 动态图片数据
+@interface XDGTapTapMomentImageData : XDGTapTapMomentPostData
+
+/**
+@brief 图片本地路径（可选）
+@warning 数组最多可存一个，超出部分截选第一个
+*/
+@property (nonatomic, copy, nullable) NSArray<NSString *> *images;
+
+/**
+@brief 文字内容（可选）
+@warning 文字长度限制为1200，超过1200取前1200
+*/
+@property (nonatomic, copy, nullable) NSString *content;
+
+@end
+
+
+
+NS_ASSUME_NONNULL_END

package/Plugins/iOS/XDTapSDK4WrapperSDK.framework/Headers/XDGTapTapMomentDelegate.h.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: 8ca9ef6c0b35d4f40af51a70daf0dcab
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Plugins/iOS/XDTapSDK4WrapperSDK.framework/Headers/XDGTapTapMomentWrapper.h

@@ -0,0 +1,64 @@
+//
+//  XDGTapTapMomentWrapper.h
+//  XDTapSDK4WrapperSDK
+//
+//  Created by Fattycat on 2025/12/3.
+//
+
+#import <Foundation/Foundation.h>
+#import <XDTapSDK4WrapperSDK/XDGTapTapMomentDelegate.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/// TapTap 动态封装类
+@interface XDGTapTapMomentWrapper : NSObject
+
++ (instancetype)new NS_UNAVAILABLE;
+
+- (instancetype)init NS_UNAVAILABLE;
+
+/// 设置代理
+/// @param delegate 代理
++ (void)setDelegate:(id <XDGTapTapMomentDelegate>)delegate;
+
+/// 打开动态
++ (void)open;
+
+/// 打开指定场景的动态
+/// @param sceneId 场景 ID
++ (void)openScene:(NSString *)sceneId;
+
+/// 发布动态
+/// @param content 发布的动态内容
+/// @warning `content`参数：动态内容为视频请选择`XDGTapTapMomentVideoData`, 动态内容为图片时请选择 `XDGTapTapMomentImageData`。
++ (void)publish:(XDGTapTapMomentPostData *_Nonnull)content;
+
+/// 关闭所有内嵌窗口
+/// @param title 弹窗标题
+/// @param content 弹窗内容
+/// @param showConfirm 是否显示确认弹窗
+/// @warning 传空或者空串不弹框
++ (void)closeWithTitle:(NSString *)title
+               content:(NSString *)content
+           showConfirm:(BOOL)showConfirm;
+
+/// 直接关闭所有内嵌窗口
+/// @warning 该方法不弹二次确认窗口
++ (void)close;
+
+/// 获取新动态数量
+/// @warning 结果在 `Delegate` 下的 `onMomentCallbackWithCode:msg:`, code == TM_RESULT_CODE_NEW_MSG_SUCCEED时，`msg` 即为消息数量
++ (void)fetchNotification;
+
+/// 获取SDK版本名
++ (NSString *)getSdkVersion;
+
+/// 获取SDK版本号
++ (NSString *)getSdkVersionCode;
+
+/// 项目自己的Controller 需要设置 DeferSystemGestures配置
++ (void)needDeferSystemGestures;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/Plugins/iOS/XDTapSDK4WrapperSDK.framework/Headers/XDGTapTapMomentWrapper.h.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: e02d846d814174c8c98c74408e24a07d
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Plugins/iOS/XDTapSDK4WrapperSDK.framework/Headers/XDTapSDK4WrapperSDK.h

@@ -15,6 +15,19 @@ FOUNDATION_EXPORT const unsigned char XDTapSDK4WrapperSDKVersionString[];
 
 // In this header, you should import all the public headers of your framework using statements like #import <XDTapSDK4WrapperSDK/PublicHeader.h>
 
-#define XDGTapSDK4_VERSION @"7.2.0"
-#define XDGTapSDK4_VERSION_CODE @"7020000"
-// HASH 8d15387e
+#define XDGTapSDK4_VERSION @"7.3.0"
+#define XDGTapSDK4_VERSION_CODE @"7030000"
+// HASH 12db4772
+
+// 对外导出的协议和封装类
+// Achievement
+#import <XDTapSDK4WrapperSDK/XDGTapTapAchievementCallback.h>
+#import <XDTapSDK4WrapperSDK/XDGTapTapAchievementWrapper.h>
+
+// CloudSave
+#import <XDTapSDK4WrapperSDK/XDGTapTapCloudSaveCallback.h>
+#import <XDTapSDK4WrapperSDK/XDGTapTapCloudSaveWrapper.h>
+
+// Moment
+#import <XDTapSDK4WrapperSDK/XDGTapTapMomentDelegate.h>
+#import <XDTapSDK4WrapperSDK/XDGTapTapMomentWrapper.h>

package/Resources/Prefabs/GeneralAgreementAlert.prefab

@@ -133,7 +133,7 @@ MonoBehaviour:
   m_Script: {fileID: 11500000, guid: 5f7201a12d95ffc409449d95f23cf332, type: 3}
   m_Name: 
   m_EditorClassIdentifier: 
-  m_Material: {fileID: 2100000, guid: cb7e1a0e9ae57274b80858a808d7c9ba, type: 2}
+  m_Material: {fileID: 0}
   m_Color: {r: 0.13333334, g: 0.13333334, b: 0.13333334, a: 1}
   m_RaycastTarget: 1
   m_RaycastPadding: {x: 0, y: 0, z: 0, w: 0}
@@ -187,9 +187,9 @@ RectTransform:
   m_Children: []
   m_Father: {fileID: 8115389968904905495}
   m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
-  m_AnchorMin: {x: 0, y: 0}
-  m_AnchorMax: {x: 0, y: 0}
-  m_AnchoredPosition: {x: 400, y: 0}
+  m_AnchorMin: {x: 0, y: 1}
+  m_AnchorMax: {x: 0, y: 1}
+  m_AnchoredPosition: {x: 400, y: -348}
   m_SizeDelta: {x: 700, y: 0}
   m_Pivot: {x: 0.5, y: 1}
 --- !u!114 &6136117534961052962

package/Resources/Prefabs/XDSDKUI.prefab

@@ -87,6 +87,7 @@ GameObject:
   - component: {fileID: 223190507069427674}
   - component: {fileID: 114453665955884244}
   - component: {fileID: 114536875208541376}
+  - component: {fileID: 1723631138956368394}
   m_Layer: 5
   m_Name: XDSDKUI
   m_TagString: Untagged
@@ -180,6 +181,18 @@ MonoBehaviour:
   m_BlockingMask:
     serializedVersion: 2
     m_Bits: 4294967295
+--- !u!114 &1723631138956368394
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 1810664746418960}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: c91453437c3342b99c78c23bcc9e028f, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
 --- !u!1 &6203735995377905587
 GameObject:
   m_ObjectHideFlags: 0

package/Runtime/Internal/IXDGCommon.Extended.cs

@@ -13,10 +13,6 @@ namespace XD.SDK.Common.Internal
 
         void DisableAgreementUI();
 
-        void PreloadWebPage(string url);
-
-        void OpenWebPage(string url, Action<WebActionEnum, Dictionary<string, object>> callback);
-
         bool IsSteamInitialized();
     }
 }

package/Runtime/Internal/Mobile/CommonFeaturesImpl.cs

@@ -229,6 +229,26 @@ namespace XD.SDK.Common.Internal.Mobile
             });
         }
 
+        public string GetPackageType()
+        {
+            string packageType = XDGPackageType.PackageTypeDefault;
+#if UNITY_ANDROID
+            using (var commonBridgeClass = new AndroidJavaClass(BridgeConstants.Common.BridgeStaticImpl))
+            {
+                packageType = commonBridgeClass.CallStatic<string>("getPackageType");
+            }
+#elif UNITY_IOS
+            IntPtr ptr = XDCommonBridgeGetPackageType();
+            packageType = Marshal.PtrToStringAnsi(ptr);
+#endif
+            return packageType;
+        }
+        
+#if UNITY_IOS
+        [DllImport("__Internal")]
+        private static extern IntPtr XDCommonBridgeGetPackageType();
+#endif
+
         public bool IsSteamInitialized()
         {
             return false;

package/Runtime/Internal/Standalone/CommonFeaturesImpl.cs

@@ -104,9 +104,19 @@ namespace XD.SDK.Common.Internal.Standalone
 #endif
         }
 
+        public string GetPackageType()
+        {
+            if (SteamUtils.IsSDKSupported)
+            {
+                return XDGPackageType.PackageTypePCSteam;
+            }
+
+            return ConfigModule.UsingTapPC ? XDGPackageType.PackageTypePCTapTap : XDGPackageType.PackageTypePCNormal;
+        }
+
         public bool IsSteamInitialized()
         {
-            return SteamWrapper.Initialized();
+            return SteamUtils.IsSDKSupported;
         }
 
         public void DisableAgreementUI()

package/Runtime/Internal/Standalone/Steam/SteamManager.cs

@@ -1,3 +1,4 @@
+#if XD_STEAM_SUPPORT
 // The SteamManager is designed to work with Steamworks.NET
 // This file is released into the public domain.
 // Where that dedication is not recognized you are granted a perpetual,
@@ -212,6 +213,7 @@ class SteamManager : MonoBehaviour {
 		}
 		
 		var fromCmd = GetCommandArgument("from");
+		XDGLogger.Log(XDGLogLevel.Debug, XDGLoggerTag.Common, $"[Steamworks.NET] Command line from={fromCmd}", true);
 		if (!string.IsNullOrEmpty(fromCmd) && string.Equals(fromCmd, "steam", StringComparison.OrdinalIgnoreCase))
 		{
 			_startFromSteam = true;
@@ -266,6 +268,7 @@ class SteamManager : MonoBehaviour {
 	private static string GetCommandArgument(string name)
 	{
 		var args = System.Environment.GetCommandLineArgs();
+		XDGLogger.Log(XDGLogLevel.Debug, XDGLoggerTag.Common, $"[Steamworks.NET] Command line args: {string.Join(" ", args)}", true);
 		foreach (string arg in args)
 		{
 			var sepIndex = arg.IndexOf('=');
@@ -317,7 +320,11 @@ class SteamManager : MonoBehaviour {
         {
             var json = File.ReadAllText(configPath);
             var jsonObject = JObject.Parse(json);
-            var steamIDRaw = jsonObject["steam_id"]?.ToString();
+            var steamIDRaw = jsonObject["steam_appid"]?.ToString();
+            if (string.IsNullOrEmpty(steamIDRaw))
+            {
+	            steamIDRaw = jsonObject["steam_id"]?.ToString();
+            }
             
             ulong steamIDValue = 0;
             if (!string.IsNullOrEmpty(steamIDRaw) && !ulong.TryParse(steamIDRaw, out steamIDValue))
@@ -355,4 +362,5 @@ class SteamManager : MonoBehaviour {
 		}
 	}
 #endif // !DISABLESTEAMWORKS
-}
+}
+#endif // XD_STEAM_SUPPORT

package/Runtime/Internal/Standalone/Steam/SteamUtils.cs

@@ -0,0 +1,75 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+
+namespace XD.SDK.Common.Internal.Standalone
+{
+    /// <summary>
+    /// Steam SDK 封装接口
+    /// </summary>
+    public interface ISteamSDKWrapper
+    {
+        Task<string> GetAuthTicket();
+        string GetSteamId();
+        string GetSteamLanguage();
+        Task<string> GetMicroTxn(ulong orderId);
+        string GetSteamCountry();
+        bool IsInitialized();
+    }
+
+    public class SteamUtils
+    {
+        private static readonly Lazy<SteamUtils> _instance = new Lazy<SteamUtils>(() => new SteamUtils());
+        public static SteamUtils Instance => _instance.Value;
+
+        private SteamUtils()
+        {
+        }
+
+        private static ISteamSDKWrapper WrapperInstance { get; set; }
+
+        static SteamUtils()
+        {
+            Type interfaceType = typeof(ISteamSDKWrapper);
+            Type steamWrapperType = AppDomain.CurrentDomain.GetAssemblies()
+                .SelectMany(assembly => assembly.GetTypes())
+                .FirstOrDefault(clazz => interfaceType.IsAssignableFrom(clazz) && clazz.IsClass);
+            if (steamWrapperType != null)
+            {
+                WrapperInstance = Activator.CreateInstance(steamWrapperType) as ISteamSDKWrapper;
+            }
+        }
+
+        public Task<string> GetAuthTicket()
+        {
+            return IsInitialized() ? WrapperInstance.GetAuthTicket() : Task.FromResult(string.Empty);
+        }
+
+        public string GetSteamId()
+        {
+            return IsInitialized() ? WrapperInstance.GetSteamId() : string.Empty;
+        }
+
+        public string GetSteamLanguage()
+        {
+            return IsInitialized() ? WrapperInstance.GetSteamLanguage() : string.Empty;
+        }
+
+        public Task<string> GetMicroTxn(ulong orderId)
+        {
+            return IsInitialized() ? WrapperInstance.GetMicroTxn(orderId) : Task.FromResult(string.Empty);
+        }
+
+        public string GetSteamCountry()
+        {
+            return IsInitialized() ? WrapperInstance.GetSteamCountry() : string.Empty;
+        }
+
+        public bool IsInitialized()
+        {
+            return WrapperInstance != null && WrapperInstance.IsInitialized();
+        }
+
+        public static bool IsSDKSupported => Instance.IsInitialized();
+    }
+}

package/Runtime/Internal/Standalone/Steam/SteamUtils.cs.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: 6c8ea028a94d432bb5d319082e7da902
+timeCreated: 1766043372