/noname-pwa

Progressive Web App of noname | 无名杀的 “渐进式网络应用程序” 版本 #三国杀

Primary LanguageJavaScript

noname-PWA

无名杀是基于社区的开源、免费的三国杀客户/服务端。

无名杀的 “渐进式网络应用程序 (Progressive Web App)” 版本 —— 点击体验

点击查看 PWA 版本的部署仓库

简介

本仓库基于 无名杀网页版 构建了 PWA 版本。简言之,相比原网页版,PWA 技术使得无名杀能够借助浏览器轻松地进行跨平台安装,为用户提供接近原生应用的体验,可以做到按需加载离线运行自动更新等。当然,即使不安装到本地,用户仍旧可以直接通过浏览器进行游戏(即所谓的 "Progressive")。有关 PWA 的详细介绍请参见 维基百科

改动

为了添加 PWA 支持,主要针对原网页版做了如下改动:

  1. 增加了 PWA 相关的配置文件与资源文件。
  2. 由于 PWA 要求通过 HTTPS 提供服务,因此已将联机设置中的默认连接协议设置为 WSS 协议,如需使用不安全的 WS 协议,则应明确指定。同时,WS 和 WSS 的默认端口也分别设置为标准的 80443(与官方的 8080 不同),如需连接其它端口,也应明确指定。例如,无名杀官方提供的联机大厅地址应写作:ws://47.99.105.222:8080
    • 注意:一般情况下,在使用 HTTPS 时 WS 协议会被浏览器安全策略阻止(除非连接的是本机地址)。如果您必须使用 WS 协议,请参考此页面
  3. 针对 Android 设备,增加了 “连续两次返回键退出” 功能,避免误触退出游戏。
  4. 将 ttf 字体替换为 woff2 格式,以减小文件体积。

游戏与安装

A. 安装 PWA 到本地(支持离线游戏)

Windows / Linux / Mac / Android

推荐使用基于 Chromium 内核的浏览器(如 Chrome, 新版 Edge),移动设备请确保打开了浏览器创建桌面快捷方式的权限。访问无名杀的站点地址(Firefox 可能存在显示 bug),然后打开浏览器菜单,点击 “安装应用” (若只看到 “添加到主屏幕”,请稍等一两分钟并刷新,或者等待浏览器自动弹出安装请求)。

iOS

iOS 仅 Safari 浏览器可以安装 PWA,请访问无名杀的站点地址,点击分享按钮,将无名杀添加到主屏幕。

B. 网页版

推荐使用基于 Chromium 内核的浏览器(如 Chrome, 新版 Edge),访问无名杀的站点地址即可开始游戏。

注意:

  • 初次访问无名杀站点时可能会提示 “是否重置游戏”,移动设备会提示 “是否切换到触屏模式”,确认即可。
  • Safari 用户如果要使用联机功能,请确保实验性功能中的 NSURLSession WebSocket 处于开启状态。

FAQ

  • 多次弹窗提示 “游戏似乎未正常载入,是否重置游戏”

    因游戏文件体积较大,初次打开需要一定时间加载。此时同意即可,一般多刷新几次就能加载好了。

  • 连接官方提供的联机大厅时提示 “当前的安全策略不允许未经加密的 WebSocket 连接”。

    官方联机大厅采用的是未经加密的 WebSocket 连接,通常情况下浏览器会进行阻止。如果您必须连接这个地址,请参考此页面