{"id":18938245,"url":"https://github.com/wechat-miniprogram/minigame-playable","last_synced_at":"2025-04-15T19:30:26.108Z","repository":{"id":205728581,"uuid":"711779536","full_name":"wechat-miniprogram/minigame-playable","owner":"wechat-miniprogram","description":null,"archived":false,"fork":false,"pushed_at":"2024-04-10T03:41:05.000Z","size":12041,"stargazers_count":6,"open_issues_count":3,"forks_count":0,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-04-10T05:00:46.747Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wechat-miniprogram.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2023-10-30T06:51:58.000Z","updated_at":"2024-04-15T11:00:47.509Z","dependencies_parsed_at":null,"dependency_job_id":"b8133939-dd72-4945-9c7d-a2cae8650605","html_url":"https://github.com/wechat-miniprogram/minigame-playable","commit_stats":null,"previous_names":["wechat-miniprogram/minigame-playable"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wechat-miniprogram%2Fminigame-playable","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wechat-miniprogram%2Fminigame-playable/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wechat-miniprogram%2Fminigame-playable/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wechat-miniprogram%2Fminigame-playable/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wechat-miniprogram","download_url":"https://codeload.github.com/wechat-miniprogram/minigame-playable/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249138495,"owners_count":21218897,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-08T12:13:53.316Z","updated_at":"2025-04-15T19:30:22.105Z","avatar_url":"https://github.com/wechat-miniprogram.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 小游戏试玩\n小游戏试玩是一种独立于小游戏之外的更轻量的运行时，其应用场景主要是在正式进入小游戏之前拉起一个轻量的运行时，能够让玩家先简单体验游戏的部分玩法，典型的应用场景是在小游戏激励视频场景，通过真实的游戏试玩来替代用户观看视频的体验。本仓库旨在维护小游戏试玩的一些示例和针对小游戏试玩提供的通用适配层。\n\n## 示例\n\ndemos 目录主要承载一些第三方引擎的示例。\n因为小游戏试玩依赖于独立分包能力，所以一个包含小游戏试玩包的游戏实际上至少包含了两个完整的游戏，为了方便组织 demo 目录，minigame-demo 目录作为小游戏主工程，其他 demo 会构建到 `demos/minigame-demo/playableDemo` 作为小游戏试玩工程，目录结构如下：\n```\ndemos\n |--cocoscreator3-ball\n |--minigame-demo // 小游戏主工程，微信开发者工具默认创建的打飞机小游戏示例\n    |--playableDemo // 其他 demo 构建到该目录下，可以灵活切换不用 demo 的小游戏试玩分包\n      |--game.js // 小游戏试玩分包入口文件\n      |--playable-adapter.js // 小游戏试玩通用适配器\n      |--...  // demo 构建出来的其他产物\n\n```\n\n### 弹弹乐3D游戏\n弹弹乐 3D 游戏（cocoscreator3-ball目录）是 Cocos Creator 的官方 demo，原始工程可查看[链接](https://github.com/cocos/cocos-example-ball)，此处仅用作示例，请勿用于商业用途。\n\n最终试玩运行效果真机截图如下：\n\n\u003cimg src=\"assets/images/balldemo.png\" width=\"400\"\u003e \u003cimg src=\"assets/images/balldemo2.png\" width=\"400\"\u003e\n\n原始工程从小游戏构建为试玩只需要简单两步：\n1. 以Cocos Creator项目为例，新建小游戏构建模板，在构建模板引入适配器，小游戏构建模板目录如下`build-templates`，其中 **playable-adapter.js** 文件来自 **playable-adapter/dist/playable-adapter.js**，详情可见下面小游戏试玩适配器(playable-adapter)介绍。\n```\ncocoscreator3-ball\n |--assets\n |--build\n |--build-templates\n    |--wechatgame\n      |--game.ejs\n      |--game.json\n      |--playable-adapter.js\n      |--project.config.json\n\n```\n\n2. game.ejs 引入和初始化适配代码：\n``` js\n// 引用适配器\nconst PlayableAdapter = require('./playable-adapter.js').PlayableAdapter;\n\n// 小游戏试玩支持多个独立分包，因此初始化需要传入独立分包的路径\nnew PlayableAdapter({\n  userPathPrefix: 'playableDemo/',\n});\n```\n\n如果不使用构建模板，只需要在构建后的 game.js 引入和初始化适配器。\n\n## 小游戏试玩适配器(playable-adapter)\n小游戏试玩环境并不是标准的小游戏环境，第三方游戏引擎构建为小游戏之后大概率会遇到各种报错，这些报错主要分两类：\n1. 游戏引擎认为当前处于小游戏环境下，访问了一些小游戏特有的 API；\n2. 小游戏试玩使用本地文件如音频和配置文件必须加上独立分包的名字作为前缀如`playableDemo/`;\n\n小游戏试玩适配器的目的就是为了简化开发者对小游戏试玩环境的适配工作，通过引入 playable-adapter，能够避免上述两个问题。\n\n### 自定义适配器\n目前适配器能够覆盖 Cocos Creator 引擎 \u003e= 2.4.11 版本和 \u003e= 3.8.0 版本，如果使用其他版本 Cocos 或者其他引擎，可自定增加适配规则，执行构建。\n\n1. 安装依赖\n``` shell\ncd playable-adapter \u0026\u0026 npm install\n```\n\n2. 构建\n``` shell\nnpm run dev\n```\n\n构建后的文件为**playable-adapter/dist/playable-adapter.js**。","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwechat-miniprogram%2Fminigame-playable","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwechat-miniprogram%2Fminigame-playable","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwechat-miniprogram%2Fminigame-playable/lists"}