趣头条游戏中心离线包

为了提升游戏加载速度，趣头条App会提前把首屏游戏资源打包到客户端，在访问游戏资源的时候根据配置的路径匹配规则，命中的资源直接读取客户端本地文件，省去了网路请求和服务端的开销。

在第一次接入离线包的时候游戏方需要提供：

1. 游戏名称（必须）：和游戏中心显示的一致。
2. 资源路径（必须）：游戏访问资源相对于域名所在的路径，游戏中心只会抓取这个路径下的资源，路径外的资源不会管，不能是跟目录 /，也不能是一些容易重复的字段，如：/h5/、/prod/等，建议是游戏拼音或英文缩写，如：/ffyqs/、/first-world/。

案例：

1. 游戏名称：发发摇钱树
2. 资源路径：/game/prod/ffyqs/

游戏中心首次配置完成后(微信:MazeyQian)，此时游戏已经拥有访问离线包的功能，在切换底导和重启App的时候会自动检测离线包资源是否更新并下载资源。

游戏资源更新的时候[1]可依照接口文档主动更新离线包，[2]也可以将资源路径下的资源打包（ZIP）给游戏中心，让游戏中心手动更新离线包。

接口文档

1.主动更新离线包

请求方式：POST

HOST：game-offline.1sapp.com

请求URI: /offline/updateouterbag

参数	是否必须	类型	描述
bagEnv	是	string	生产为:offline，测试为:offline/test
path	是	string	资源路径，如：/game/prod/ffyqs/，前后都要加 /
conversion	是	string	游戏开始按钮的坐标，eg: "0,0"
gameUrl	是	string	游戏可访问url

返回

参数	是否必须	类型	描述
code	是	number	接口返回code值
payload	是	json	返回的主体内容，requestId：查询更新进度所需参数
message	是	string	错误信息

示例：

请求

POST /offline/updateouterbag? HTTP/1.1
Host: game-offline.1sapp.com
Content-Type: application/json
cache-control: no-cache
{
    "bagEnv": "offline",
    "path": "/game/prod/ffyqs/",
    "conversion": "0,0",
    "gameUrl": "http://newidea4-gamecenter-frontend.1sapp.com/game/prod/ffyqs/index.html?app_id=a3yYtwjTsHvJ&source=286100"
}

返回

{
    "code": 0,
    "payload": {
        "requestId": "20191019174351274"
    },
    "message": "success"
}

主动更新 Postman 参考：

2.更新离线包进度查询

请求方式：POST

HOST：game-offline.1sapp.com

请求URI: /offline/updateprogress

参数	是否必须	类型	描述
requestId	是	string	更新离线包的请求ID

返回

参数	是否必须	类型	描述
code	是	number	接口返回code值
payload	是	json	返回的主体内容
message	是	string	错误信息

示例：

请求

POST /offline/updateprogress HTTP/1.1
Host: game-offline.1sapp.com
Content-Type: application/json
cache-control: no-cache
{   
    "requestId": "20191019174351274"
}

返回

{
    "code": 0,
    "payload": {
        "progress": "100%",
        "bagUrl": "http://game-cdn.1sapp.com/offline/release/20191019174351274.zip",
        "description": "....",
        "gameUrl": "https://cdn.heidong.midsummer.top/release/20191015213749/index.html?app_id=a3E67uTiPJw5&app_name=%E7%8C%9C%E6%88%90%E8%AF%AD%E6%8B%BF%E9%87%91%E5%B8%81&appid=a3E67uTiPJw5&dc=868237046772793&ext=eyJzb3VyY2UiOiIyODYxNjYifQ%3D%3D&origin_type=0&platform=qtt&sign=2e2cc6cadaf7c7d5ccfd1b435330f4c6&source=286166&ticket=t11XUatVTysECAfYUwrab&time=1571477991&uuid=2544805&v=30946000&vn=3.9.46.000.1009.2251&dtu=014&lat=0.0&lon=0.0&screen_location=2"
    },
    "message": "success"
}

Q&A

Q: 资源路径是什么?

A: 以发发摇钱树为例。

提供的路径是 /game/prod/ffyqs/，则只会离线 /ffyqs/ 下面的 /res/ /ani/ 等资源，而 /moregame/ 路径下面的资源不离线。

Q：离线包会有什么限制？

A：目前建议大小限制在 30M 之内。

Q: 提供打包资源的时候，打包的是什么?

A：以发发摇钱树为例。

路径是 /game/prod/ffyqs/，则提供的是 /ffyqs/ 下面的打包资源。

Q：提供打包资源的时候，有什么建议？

A：离线包更频率越小越好，建议只打包不常更新的静态资源，迭代比较快的资源建议剔除掉（例如：index.html，业务 JS 文件）。