手机 - 全面改造

-----------------------------------------------------------------
简介：
-----------------------------------------------------------------
手机 - 全面改造 将游戏中的基础手机转变为真正的智能手机。

欢迎在评论区留下你的建议 :)




-----------------------------------------------------------------
用户 - 新功能：
-----------------------------------------------------------------
-> 正确尺寸的4x4应用网格。
-> 将你的应用移动到任何你想放的位置。
-> 随心所欲地添加和删除页面。
-> 移动并调整日期和时间的大小。

-> 控制器自定义导航支持。

-> 通过模组管理器选项隐藏基础游戏商店。

-> 内置壁纸应用，可随时更换手机壁纸，支持PNG和MP4格式。


-----------------------------------------------------------------
用户 - 如何使用手势：
-----------------------------------------------------------------
鼠标和键盘：
-> 按住左键滑动即可切换页面。（或使用A/D或←→键）。
-> 按住右键拖动应用即可移动。
-> 将应用拖到屏幕边缘即可切换页面，或者在按住应用时使用 A/D 或 ← →。
-> 按住应用时，在最后一页，将鼠标悬停在屏幕右侧边缘靠近边框的位置，就会创建新页面。
-> 在空白页上按住右键并向上滑动即可删除该页。（如果有应用则不会生效）。

控制器：
-> 移动摇杆或方向键应能让你切换到网格中的下一个槽位。
-> 移动到页面最右侧/最左侧，向右/向左移动到下一页/上一页。

目前不支持在手柄上移动应用。
暂不支持在控制器上创建新页面。
暂不支持在控制器上删除页面。

-----------------------------------------------------------------
用户 - 如何修改日期和时间：
-----------------------------------------------------------------
-> 在Bepin菜单中启用PhoneScreenEditing。
-> 你可以使用下方的滑块，或者按住鼠标左键拖动日期和时间来调整。你也可以使用滚轮来更改大小。 

完成日期和时间设置后，请关闭“PhoneScreenEditing”。

你的时间和日期位置保存在： BepInEx\config\munch.PhoneOverhaul.cfg
-> 模组作者可能会自带这些文件。如果你不想让自己的文件被覆盖，请多加留意。

你的应用和页面布局位置保存在： BepInEx\config\munch.PhoneOverhaul.Layouts.cfg
-> 模组作者可能会自带。如果你不想自己的被覆盖，请留意。

-----------------------------------------------------------------
安装 - 用户：
-----------------------------------------------------------------
选项 1) - 解压到 G:\SteamLibrary\steamapps\common\TCG Card Shop Simulator
选项2） - 将 Bepinex 文件夹复制粘贴到 G:\SteamLibrary\steamapps\common\TCG Card Shop Simulator

-----------------------------------------------------------------
壁纸指南：
-----------------------------------------------------------------
在以下路径中创建子文件夹：G:\SteamLibrary\steamapps\common\TCG Card Shop Simulator\BepInEx\plugins\Phone - Overhaul\Wallpaper

子文件夹的名称将用作壁纸应用中文件夹目录的名称。

-> 在你的子文件夹中，放置一张名为 Icon.png 的图片，它将用作壁纸应用（主屏幕）中的文件夹图标。
→ 在你的子文件夹中，放入任意命名的 png（除了“Icon”），它将作为壁纸使用，并会在游戏中被自动检测到。
-> 在你的子文件夹中，放置任意命名的 Mp4 文件（“Icon”除外），它将被用作 MP4 壁纸，并自动循环播放且静音。
-> 在你的子文件夹中，为你拥有的每个 Mp4 创建一个预览图标，供 App 用作预览。该 .png 的名称必须与 Mp4 相同，并以“_Icon”结尾。

MP4示例：
宝可梦壁纸
Wallpaper\Pokemon\Icon.png
壁纸\宝可梦\喷火龙.mp4
壁纸\宝可梦\喷火龙_图标.png

-----------------------------------------------------------------
安装 - MOD 作者：
-----------------------------------------------------------------
→ G:\SteamLibrary\steamapps\common\TCG Card Shop Simulator\BepInEx\Plugins\Phone - Overhaul\App Images
 如果你要制作新应用，请将你的应用图片文件夹打包在 Phone - Overhaul 模组中一并发布。

-> G:\SteamLibrary\steamapps\common\TCG Card Shop Simulator\BepInEx\Plugins\Phone - Overhaul\Wallpaper
 如果你要提供壁纸，请将Phone - Overhaul里的Wallpaper文件夹随你的模组一起打包。

-> G:\SteamLibrary\steamapps\common\TCG Card Shop Simulator\BepInEx\config\munch.PhoneOverhaul.cfg
如果你想用户拥有你的昼夜与时间设置，请将其随模组一起发布。

-> G:\SteamLibrary\steamapps\common\TCG Card Shop Simulator\BepInEx\config\munch.PhoneOverhaul.Layouts.cfg
如果你希望用户拥有你的应用和页面布局，请将其与你的模组一起发布。

不要在你的模组中加入任何其他内容。
用户必须在此处下载手机大修模组。


---------------------------------------------------------------
API指南 - 模组作者：
---------------------------------------------------------------



-----------------------------------------------------------------
API指南：
-----------------------------------------------------------------
API允许你注册自己的应用，它会以独立图标和自定义逻辑显示在手机主屏幕上。当玩家点击你的图标时，就会运行你指定的任何代码。这非常适合打开模组的自定义界面、执行某个函数，或者你能想到的任何其他用途。

你还可以向玩家发送通知——弹出提示、角标计数，或两者同时发送。通知会自动带有你的应用品牌标识。

我还附上了一个可选的、可下载的模板文件，你可以直接放进现有项目里，它一目了然，用起来也很简单。
只需记得在项目中同时引用基础 Phone - Overhaul.dll，否则你将无法使用该 API。

获取注册表

所有内容都通过单一入口点。在启动代码中获取一次即可。

var registry = PhoneOverhaulAPI.Registry;
如果（registry 不为空）
{
// 你已经准备好了——注册应用、发送通知等等。
}

应用注册

注册方法

API的核心是一个单一的方法调用：Register()。你将一个AppSpec对象传入此方法，其中包含了你应用的所有设置。你需要在模组的启动代码中运行它（比如在MonoBehaviour的Awake()方法里）。

注册新的应用规格
{
AppId = "MyCoolMod",
显示名称 = "我的应用"，
"图标 = \"MyIcon\","
InnerBackground = null,
外部背景 = null，
OnClick = MyCoolAppEvents.HandleClick
});

应用程序规范对象

这是保存你应用所有设置的对象。你只需为每个字段填写详细信息：

-> 应用ID（字符串）
这是最重要的字段。它是你的应用的唯一标识符，比如“MyCoolMod”或“Pokemod”。这个ID必须与你为应用图片创建的文件夹名称一致。保持简洁，不要有空格或奇怪字符。

-> 显示名称 (字符串)
这是将显示在手机屏幕上应用图标下方的名称。

-> 图标（字符串）
你的图标文件名（例如“MyIcon”）。
不要包含.png扩展名。
如果希望使用默认值，可以留空。
你可以使用互联网上的任何 png 图片，它会自动正确缩放。
使用透明背景。

-> 内部背景（字符串）
-> 外部背景 (字符串)
这些是用于自定义应用图标背景的，如果你想玩点花样的话。
就像图标一样，提供不带扩展名的文件名。
如果你想使用默认值，可以留空。
这必须反映原始背景的正确尺寸。
IE；256x256透明背景，96x96图像。
我已在Phone - Overhaul\Base Game Assets里创建了一个包含基础游戏背景资源的文件夹。

-> 点击时（动作）
你只需将其指向应用被点击时你想要运行的方法。

通知

通知系统分为三个层级：仅吐司通知、仅徽章通知和推送通知（两者同时触发）。所有通知方法都会返回一个布尔值——成功则为真，如果找不到应用ID或某些内容无效则为假。你传入的应用ID必须与你已注册的应用相匹配。

Toast通知

Toast 是从屏幕左侧滑入的弹出面板。它们会显示你的应用名称，播放通知音效，并在设定时间后自动消失。多个 Toast 会向下堆叠。

// 默认10秒提示
registry.ShowNotification("MyCoolMod", "有情况发生了！");

// 自定义持续时间（限制在1到60秒之间）
registry.ShowNotification("MyCoolMod", "快速警报！", 3f);

徽章计数器

徽章是应用图标上出现的小橙色圆圈，显示未读计数（超过9时显示“9+”）。这些计数会在存档间保留，因此玩家不会丢失他们的计数。

// 将徽章设置为确切数字（0 则隐藏）
registry.SetBadgeCount("MyCoolMod", 5);

// 获取当前计数
int count = registry.GetBadgeCount("MyCoolMod");

// 加到计数上（默认为+1）
registry.IncrementBadge("MyCoolMod");
registry.IncrementBadge("MyCoolMod", 3);

// 从计数中减去（不会低于 0）
registry.DecrementBadge("MyCoolMod");
registry.DecrementBadge("MyCoolMod", 2);

推送通知（浮窗加角标）

这是一体化选项。它会在一次调用中同时显示提示并让角标加1。非常适合“你有一条新消息”这类提醒。

// 提示与徽章增量一次调用
registry.SendPushNotification("MyCoolMod", "新物品已上架！");

// 使用自定义提示显示时长
registry.SendPushNotification("MyCoolMod", "新物品已上架！", 8f);

典型模式

常见做法是在后台发生某些事情时发送推送通知，然后在玩家打开你的应用时清除角标。

// 在你模组逻辑的某处……
registry.SendPushNotification(“MyCoolMod”，“你收到了一个新报价！”);

// 在你应用的 OnClick 处理程序中……
registry.SetBadgeCount("MyCoolMod", 0);