海螺系列捕鱼客户端编译及架设文档（完整版）

捕鱼客户端教程文档（完整版）
文档目录：
1. 安装运行库、Java和Unity3D

⑴ 安装运行库

⑵ 安装Java

⑶ 安装Unity3D 2018

⑷ 添加Unity3D授权

⑸ 安装Unity3D跨平台支持工具

2. 打开Unity工程并进行相关设置

⑴ 打开工程

⑵ 设置Unity编辑器内运行平台

⑶ 修改打开源码编辑使用的VS版本

3. 修改客户端配置

⑴ 打开客户端VS工程

⑵ 修改区服ID

⑶ 修改中心服务器IP地址

⑷ 启动Oss Browser

⑸ 设置访问客户端服务的权限账户和密钥

⑹ 添加领取礼包功能的数据表

⑺ 上传客户端热更新资源至OSS

⑻ 启动客户端

4. 客户端增加小游戏

⑴ 打开子游戏的客户端VS工程

⑵ 修改区服ID

⑶ 修改中心服务器IP地址

⑷ 启动Oss Browser

⑸ 设置访问客户端服务的权限账户和密钥

⑹ 上传客户端热更新资源至OSS

⑺ 启动客户端

5. 其它说明及问题解决相关

⑴ OSS地址换行符错误

⑵ 编辑器内运行资源丢失问题

⑶ 其它运行平台上传热更新资源问题

⑷ 游戏登录场景

⑸ 开启和关闭奖券兑换功能

⑹ 子游戏在大厅中的配置

⑺ 微信登录和支付配置

⑻ 小游戏工程运行后进不去游戏

⑼ 资源热更新相关

⑽ 支付修改

⑾ 添加和关闭机器人

⑿ 捕鱼难度调整

⒀ 开启比赛模式

1. 安装运行库、Java和Unity3D

⑴ 安装运行库
安装客户端工程使用运行库，如本地已安装相关运行库，则不需要重新安装。

Microsoft .NET Framework安装顺序：先安装低版本，再安装高版本。

⑵ 安装Java
安装JDK和Jre。

⑶ 安装Unity3D 2018
① 安装Unity3D 2018，安装前，需要断开网络。

② 设置安装路径后进行安装。

⑷ 添加Unity3D授权

① 以管理员身份运行授权工具。

② 设置Unity3D下的Editor目录。

③ 设置License Options（授权配置），授权配置的具体设置参照上图，设置完成后选OK保存授权配置。

④ 选择Randomize（生成授权码）。

⑤ 选择FORCED Create License（创建授权文件）。

⑥ 选择PATCH（安装授权文件）。

⑦ 打开Unity程序，选择Work offine（离线工作）。

⑧ 关闭Unity程序，并恢复网络。

⑸ 安装Unity3D跨平台支持工具

① 安装Android平台支持工具，Next一路默认安装。

② 安装IOS平台支持工具，Next一路默认安装。

③ 安装WebGL平台支持工具，Next一路默认安装。

④ 安装Windows平台支持工具，Next一路默认安装。

2. 打开Unity工程并进行相关设置

⑴ 打开工程
使用Unity 2018打开工程。

⑵ 设置Unity编辑器内运行平台
设置Unity编辑器内运行平台。

⑶ 修改打开源码编辑使用的VS版本
修改打开源码编辑使用的VS版本为VS2017。

3. 修改客户端配置

⑴ 打开客户端VS工程
使用unity编辑器打开客户端unity工程，在Project视图中通过打开源码文件的方式打开客户端VS工程。

注意：不要通过手动打开sln解决方案的方式打开客户端VS工程，此方式会造成客户端VS工程内对unity的引用丢失，也无法和Unity编辑器建立连接进行调试。

⑵ 修改区服ID
修改区服ID，区服ID的设置在中心服务器数据库的mkservice子库中的t_config_zone表进行查看。

⑶ 修改中心服务器IP地址
修改中心服务器IP地址（既可以使用IP地址也可以使用域名）。

⑷ 启动Oss Browser
启动Oss Browser工具，设置OSS的AccessKey ID和AccessKeySecret，勾选记住密钥，然后登入。启动Oss Browser工具后可以查看已上传到OSS的配置文件。

Oss Browser工具存放位置：工具\客户端工具\OssBrowser

⑸ 设置访问客户端服务的权限账户和密钥
设置访问客户端服务的权限账户和密钥，相关信息在中心服务器数据库mkcenter子库里的app_key表中查看。

⑹ 添加领取礼包功能的数据表
① 按照以下步骤执行数据库脚本，为platform数据库添加领取礼包功能的数据表。

② 脚本位置：安装环境\客户端\数据库脚本\领取礼包功能数据库脚本.txt

③ 打开游戏服务器数据库platform子库，选择下面的查询，在查询界面选择新建查询。

④ 使用Notepad++打开领取礼包功能数据库脚本.txt文件。

⑤ 复制脚本代码到platform子库的查询界面中。然后运行。

⑥ 使用stop命令，关闭游戏服务器中的platform服务。

⑦ 重新启动游戏服务器中的platform服务。

⑺ 上传客户端热更新资源至OSS
① 按照以下步骤操作，上传客户端热更新资源至OSS。

② 打开OSS路径并创建新目录（HotUpdate），如上图。

③ 在HotUpdate目录下，新建子目录（Hall）。

④ 在Unity工程选择对应的运行平台，导出热更新资源包。

⑤ 导出完成后，在Unity的Console窗口下会输出done!

⑥ 导出的热更新资源文件在工程目录下的StreamingAssets目录里。

StreamingAssets路径为：Src\Client\UnityProject\StreamingAssets

⑦ 将导出到StreamingAssets目录下的对应运行平台热更新资源目录上传到OSS对应路径下，如上图。

上传可以使用直接拖拽的方式，也可以使用OSS Browser中的”文件”上传功能（上传单个文件到OSS目录下），“目录”上传功能（上传目录到OSS目录下），如上图。

⑧ OSS Browser会显示当前文件或目录的上传进度，等待上传完成即可。

⑻ 启动客户端

全部修改设置完成后，打开游戏登录场景，启动客户端。游戏登录场景：LoginScene。

4. 客户端增加小游戏

⑴ 打开子游戏的客户端VS工程
使用unity编辑器打开客户端unity工程，在Project视图中通过打开源码文件的方式打开客户端VS工程。

注意：不要通过手动打开sln解决方案的方式打开客户端VS工程，此方式会造成客户端VS工程内对unity的引用丢失，也无法和Unity编辑器建立连接进行调试。

⑵ 修改区服ID
修改区服ID，区服ID的设置在中心服务器数据库的mkservice子库中的t_config_zone表进行查看。

⑶ 修改中心服务器IP地址
修改中心服务器IP地址（既可以使用IP地址也可以使用域名）。

⑷ 启动Oss Browser
启动Oss Browser工具，设置OSS的AccessKey ID和AccessKeySecret，勾选记住密钥，然后登入。启动Oss Browser工具后可以查看已上传到OSS的配置文件。

Oss Browser工具存放位置：工具\客户端工具\OssBrowser

⑸ 设置访问客户端服务的权限账户和密钥
设置访问客户端服务的权限账户和密钥，相关信息在中心服务器数据库mkcenter子库里的app_key表中查看。

⑹ 上传客户端热更新资源至OSS
① 按照以下步骤操作，上传客户端热更新资源至OSS。

② 在HotUpdate目录下，新建各个子游戏的热更新目录。

子游戏在大厅中的配置是在Src\Client\UnityProject\Assets\Script_HotUpdate\Lua\Table目录下HotUpdate.lua文件。

子游戏的热更新文件夹命名和NameEN字段保持一致就可以了。

③ 在Unity工程选择对应的运行平台，导出热更新资源包。

④ 导出完成后，在Unity的Console窗口下会输出done!

⑤ 导出的热更新资源文件在工程目录下的StreamingAssets目录里。

StreamingAssets路径为：Src\Client\Subgame\DaDiShu_Lua\StreamingAssets

⑥ 将导出到StreamingAssets目录下的对应运行平台热更新资源目录上传到OSS对应路径下，如上图。

上传可以使用直接拖拽的方式，也可以使用OSS Browser中的”文件”上传功能（上传单个文件到OSS目录下），“目录”上传功能（上传目录到OSS目录下），如上图。

⑦ OSS Browser会显示当前文件或目录的上传进度，等待上传完成即可。

⑺ 启动客户端

① 全部修改设置完成后，打开游戏登录场景，启动客户端，游戏登录场景：LoginScene，然后在游戏主场景中启动小游戏。

② 进入小游戏之前需要有足够的金币，有的小游戏才能进入。

5. 其它说明及问题解决相关

⑴ OSS地址换行符错误
如果出现以上错误信息，是指数据库数据表中有换行导致的。需要在对应的数据表中修改数据删除掉换行，保存数据表。然后重启client的web服务。

⑵ 编辑器内运行资源丢失问题
在编辑器内运行会出现材质丢失的问题，是因为Unity虽然切到了其它平台，但终归是在Windows下运行的，有些其它平台运行上才能正常显示的东西还是看不到的。解决此问题需要将Unity切换到windows运行平台下，然后再运行项目即可。

⑶ 其它运行平台上传热更新资源问题

① 在进行不同运行平台的热更新资源导出时，必须让Unity处于对应运行平台下。

② 在进行不同运行平台的热更新资源导出时，要先进行宏定义设置。

宏定义说明：

HALL：是标记该工程为大厅主工程，这个是必须有的（小游戏里不能有HALL宏定义，大厅必须有）。

LOCAL_DEBUG：输出log，可有可无。

⑷ 游戏登录场景
游戏登录场景：LoginScene

⑸ 开启和关闭奖券兑换功能

① 将Canvas节点拖拽到场景管理器中并展开。

② 将节点RechargeUI拖拽到场景管理器中Canvas下的子节点UIParent内。

③ 展开RechargeUI节点，找到下面的子节点togTicket。

④ 在togTicket属性里勾选显示togTicket节点，Apply保存。

⑤ 然后保存RechargeUI节点。

⑥ 在场景管理器中，删除RechargeUI节点。

⑥ 修改Canvas节点的属性，将“Hall Asset Source（热更新资源模式）”的设置改为“Local Assets（本地资源更新）”，修改完成后Apply保存。也可不修改Canvas节点的属性，重新导出大厅的热更新资源文件，上传OSS。

Hall Asset Source（热更新资源模式）说明：

Local Assets（本地资源更新）：在编辑器调试时，可以使用本地资源加载，打包时要改回Update Asset Bundle（资源OSS热更新）。

Update Asset Bundle（资源OSS热更新）：在编辑器调试时，使用OSS热更新资源加载。

使用Local Assets（本地资源更新）模式，资源修改后即生效，而使用Update Asset Bundle（资源OSS热更新）模式，修改资源后，要重新导出热更新资源包，上传至OSS才会生效。

⑹ 子游戏在大厅中的配置
子游戏在大厅中的配置是在Src\Client\UnityProject\Assets\Script_HotUpdate\Lua\Table目录下HotUpdate.lua文件。

子游戏的热更新文件夹命名和NameEN字段保持一致就可以了。

⑺ 微信登录和支付配置
文件目录：安装环境\客户端\微信登陆配置文件模板\AndroidManifest – 模板.xml

① 使用Android Studio打包安卓，需要修改生成的默认文件AndroidManifest.xml。

② 打开AndroidManifest – 模板.xml文件，将上图中的红框部分，复制到生成的默认文件AndroidManifest.xml中，并修改安卓包的名称（android:name）。

注意：安卓包的名称要与Unity工程中设置的包名保持一致。

③ 在Unity工程中，有关安卓端接收Java的微信回调相关源码文件中，也要将安卓包的名称设置为与Unity工程中设置的包名保持一致。

④ Unity工程中，设置安卓包名称。

⑻ 小游戏工程运行后进不去游戏
小游戏工程运行后进不去游戏，是因为进小游戏的条件不满足导致的，需要通过控制台输出信息查询玩家ID，然后在数据库中为对应ID的玩家添加足够的金币才能进入。

添加金币说明：

在游戏服务器数据库中的子库platform中打开表：t_user_money（添加金币和钻石）。

字段：currency：修改当前金币的数值（最高支持1000亿亿）

字段：diamond:修改当前钻石数值

修改完成之后Ctrl+S保存，服务器重启platform服务（stop关闭服务，然后重新开启服务）。

⑼ 资源热更新相关
① 编辑器热更新资源存储路径：C:\Users\Administrator\AppData\LocalLow\caishen\深海财神

② 大厅热更新源码文件。

③ 小游戏热更新源码文件。

⑽ 支付修改
支付源码文件修改，在大厅工程文件中的ThirdDataModule.cs修改。

⑾ 添加和关闭机器人
捕鱼游戏和子游戏添加和关闭机器人（假人），在各游戏的Global配置表中配置。

例如捕鱼机器人开关是在FishGlobal.xlsx表里有一个字段来控制。查表：是否开启机器人，1为是，0为否。

⑿ 捕鱼难度调整
捕鱼一共5个难度，在FishRoom表的DifficultyRateArray字段控制。

⒀ 开启比赛模式
在FishRoom.xlsx表的OpenTime字段配置比赛模式在什么时间段开启。