55 lines
3.0 KiB
C#
55 lines
3.0 KiB
C#
using System.Threading.Tasks;
|
||
|
||
namespace BaseGames.Platform
|
||
{
|
||
/// <summary>
|
||
/// 平台服务抽象接口（架构 16_SupportingModules §3）。
|
||
/// 解耦游戏逻辑与平台 SDK（Steam / Console / Mobile）。
|
||
/// </summary>
|
||
public interface IPlatformService
|
||
{
|
||
// ── 初始化 / 生命周期 ──────────────────────────────────────────────────
|
||
bool IsInitialized { get; }
|
||
Task<bool> InitializeAsync();
|
||
/// <summary>每帧调用（由 PlatformBootstrap.Update 驱动），处理 SDK 回调。</summary>
|
||
void RunCallbacks();
|
||
void Shutdown();
|
||
|
||
// ── 成就 ──────────────────────────────────────────────────────────────
|
||
void UnlockAchievement(string achievementId);
|
||
void ClearAchievement(string achievementId);
|
||
Task<bool> IsAchievementUnlocked(string achievementId);
|
||
|
||
// ── 统计数据（Steam 成就进度跟踪）────────────────────────────────────
|
||
void SetStat(string statId, int value);
|
||
void IncrementStat(string statId, int increment = 1);
|
||
int GetStat(string statId);
|
||
|
||
// ── 云存档 ────────────────────────────────────────────────────────────
|
||
bool IsCloudAvailable { get; }
|
||
Task<bool> CloudSaveAsync(string fileName, byte[] data);
|
||
Task<byte[]> CloudLoadAsync(string fileName);
|
||
|
||
// ── Rich Presence ─────────────────────────────────────────────────────
|
||
void SetRichPresence(string key, string value);
|
||
void ClearRichPresence();
|
||
|
||
// ── 排行榜 ────────────────────────────────────────────────────────────
|
||
void SubmitLeaderboardScore(string boardId, long score);
|
||
Task<LeaderboardEntry[]> GetLeaderboardEntries(string boardId, int maxCount);
|
||
|
||
// ── DLC / 商城 ────────────────────────────────────────────────────────
|
||
bool IsDLCOwned(string dlcId);
|
||
|
||
// ── 覆盖层（Steam Overlay 等）─────────────────────────────────────────
|
||
void ShowOverlay(string dialog);
|
||
}
|
||
|
||
public struct LeaderboardEntry
|
||
{
|
||
public string PlayerName;
|
||
public long Score;
|
||
public int Rank;
|
||
}
|
||
}
|