OPPO开放平台 边下边玩开发者文档

OPPO开放平台 边下边玩开发者文档

本文档将向您介绍OPPO软件商店提供的边下边玩能力

什么是“边下边玩”

边下边玩是一种由OPPO软件商店提供的能力,它可以通过对软件包体进行分析,得到运行必要的模块与非必要模块。在用户安装的时候,会先传输必要的模块,当必要模块传输完成后,用户就可以启动应用进行使用,非必要模块会在用户使用的过程中逐块传输,以实现一边下载一边玩的能力。

如何接入“边下边玩”能力

“边下边玩”能力的功能完全由OPPO实现。作为开发者,您无需进行任何额外的开发,仅需提供一个V4签名即可(部分开发者无需提供,见下文)。

申请加入公测

当前边下边玩能力处于内测阶段,并未面向所有开发者和所有用户开放,如果您想要参与内测,请向我们提出申请。由于并非所有应用都会有良好的边下边玩表现(这与应用的实现方式密切相关),我们会选拔出表现相对较好的应用发布线上进行内测。


申请方式:
应用请发送邮件至:g_lyyunying@oppo.com,
游戏请发送邮件至:g_game_bd@oppo.com。
邮件正文如下:
1)应用名称:
2)应用包名:
3)应用ID:
4)开发者名称:
5)您是否愿意配合OPPO一起优化边下边玩功能:
6)您的应用(最新版本)是否符合以下条件:

条件是否满足
应用安装后不做大量资源解压缩(小于包体大小30%)是/否
应用安装后不做大量资源校验(小于包体大小30%)是/否
应用安装后不需要额外下载较大资源包是/否
应用拥有比较固定的使用流程(比如关卡游戏)是/否
如果是游戏,是否为单机游戏(应用无需填写)是/否

如果您的应用符合以下条件,我们十分建议您申请开通能力,因为您的应用更有可能在边下边玩中表现的更好:

1)应用安装后不做大量资源解压缩(小于包体大小30%);
2)应用安装后不做大量资源校验(小于包体大小30%);
3)应用安装后不需要额外下载较大资源包;
4)应用拥有比较固定的使用流程(比如关卡游戏)。
5)如果应用是游戏,则单机游戏可能会拥有更好的体验。

这些并不是强制项,如果您的应用无法满足以上多个条件,但您依旧想使用边下边玩技术,您依然可以向我们发送申请,我们会进行评估,并与您持续沟通。

上传应用的V4签名

如果您的申请已通过,但没有上传入口,则说明您的应用无需上传签名即可拥有边下边玩能力。

当您的测试申请被批准后,在OPPO开放平台的应用资料更新页面就会出现V4签名的上传入口。

上传您的V4签名(点击查看如何给应用签V4签名),通过检验后提交即可。

当前有部分合作游戏无需上传V4签名,仅需加入内测名单即可,其他类型的应用则需要上传V4签名。

等待应用审核上架

当您的应用审核上架通过后,OPPO软件商店会对您的应用进行分析预测。分析结束后,用户在安装该应用的过程中就可以体验到边下边玩能力了。

“边下边玩”能力支持范围

终端软件商店版本:>= 9.0.75
终端Android版本:>= Android S
支持终端:目前仅支持手机

为什么我的应用“边下边玩”体验不佳?

这说明您的应用基础块依赖较多,用户需要下载较大比例才可以进入游戏。您可以尝试按照以下方向进行优化更新:
1)避免安装启动后的大量资源解压缩
2)避免安装包内置的资源digest校验
3)按需加载文件,规避首次启动后短时间内的大量文件使用

如果您有其他疑问,请联系我们

为什么我开启了“边下边玩”,用户端却无法体验?

这可能是由于以下原因:
1)用户端未在设置中开启边下边玩能力。
2)您的应用包仍在分析分块中。
3)您的应用在边下边玩的系统测试中表现一般,未达到下发标准。
4)为了保证数据完整性和系统稳定性,我们只允许用户终端在同一时刻存在一个边下边玩应用。
5)用户的终端版本不符合要求或者未被选中为内测用户。

OPPO开放平台API传包能力接入 查询普通包详情

OPPO开放平台API传包能力接入 查询普通包详情

更新说明

更新时间更新说明
2022-06-08
请求参数新增age_level、adaptive_equipment、adaptive_type、customer_contact,删除player_customer_email、player_customer_phone、player_customer_qq

接口功能

此接口用于通过包名查询普通包应用的详细信息。

接口原型

-请求路由:/resource/v1/app/info
-请求方法:GET
-请求类型:Content-Type: x-www-form-urlencoded

请求参数

参数类型必传说明
pkg_namestring必传应用包名
version_codestring非必传版本号,默认取最新版本

请求响应

响应说明

字段类型说明
errnoint错误码,为0表示成功
dataDetailBody应用详情,响应结构参考DetailBody

DetailBody

字段类型说明备注
app_idstring应用ID
pkg_namestring应用包名
typeint应用类型,7-普通应用;8-合作游戏;10-合作应用
signstring包签名
dev_idstring应用所属开发者ID
app_secretstring游戏支付 (私钥)
server_secretstring
app_keystring游戏支付key (公钥)
update_timedatetime应用更新时间
app_create_timedatetime应用创建时间
app_namestring应用名称
is_freezestring应用是否被冻结, 0-否;1-是
freeze_reasonstring被冻结原因
refuse_reasonstring审核拒绝原因
tag_liststring游戏标签
is_businessstring是否合作,0-否;1-是
game_typestring应用类型,1 单机;2 网游;3 棋牌;5 超休闲
second_category_idstring二级分类ID
third_category_idstring三级分类ID
copyright_urlstring软件版权证明
special_urlstring特殊类证书
special_file_urlstring特殊类证书压缩包
freeze_filestring冻结附件
business_usernamestring商务联系人姓名
business_emailemail商务联系人邮箱
business_mobilestring商务联系人电话
business_qqstring商务联系人QQ
business_positionstring商务联系人职务
business_addressstring商务联系人地址
freeze_advicestring冻结建议
app_typestringapp类型,0-未设置;1-合作应用
app_real_typestringapp类型,0-非合作状态;1-合作状态
ad_typestring买量游戏类型,1-买量游戏;2-联运买量游戏
dev_namestring
electronic_cert_urlstring电子版权证书
icp_urlstringICP备案网址或备案号
relation_app_idstring关联合作游戏
ascription_typestring游戏归属权,1-自研;2-代理合作游戏返回
authorize_typestring软件著作权登记类型;1-著作权证书合作游戏返回
proxy_contract_urlstring授权合同或协议/代理授权合同或协议合作游戏返回
authorize_urlstring软件著作权登记证合作游戏返回
authorize_descstring软件著作权登记号合作游戏返回
operation_license_urlstring网络文化经营许可证合作游戏返回
approval_doc_urlstring游戏版号证书合作游戏返回
culture_record_urlstring文化部备案文件合作游戏返回
approval_doc_numberstring游戏版号编号合作游戏返回
culture_record_numberstring文化部备案文件编号合作游戏返回
approval_doc_typestring版号有效期类型,1-永久有效;2-固定游戏期合作游戏返回
approval_doc_start_timedatetime版号有效期开始时间合作游戏返回
approval_doc_end_timedatetime版号有效期结束时间合作游戏返回
other_cetificate_urlstring其他补充资质合作游戏返回
absolve_declare_urlstring免责声明合作游戏返回
record_identification_codestring备案识别码合作游戏返回
record_identification_imagestring渠道绑定截图合作游戏返回
version_idstring版本ID
version_codestring版本号
version_namestring版本名称
apk_urlstringapk文件地址
apk_sizestringapk文件大小
apk_md5stringapk文件md5
header_md5string包头部md5
channelstring
package_permissionstring[]应用权限
resolutionstring分辨率
version_typestring版本类型,1-新增;2-更新;3更新资料
create_timedatetime创建时间
min_sdk_versionstring
target_sdk_versionstring
ver_second_category_idstring对应版本二级分类
ver_third_category_idstring对应版本三级分类
release_typestring版本发布类型,1-全量发布;2-分阶段发布;3-内部分阶段发布包
release_over_typestring分阶段结束发布类型,1-分阶段结束全量发布;2-分阶段结束下架
phone_supportstring是否要手机端支持,0-否;1-是
phone_support_versionstring手机端版本要求
ios_linkstring是否支持IOS设备,1-否;2-是
apk_full_urlstringapk文件完整地址
online_typestring发布类型,1-审核立即发布;2-定时发布
sche_online_timedatetime定时发布时间
test_typestring测试类型
test_start_timedatetime游戏内测开始时间
test_end_timedatetime游戏内测结束时间
is_signaturestring是否签名,0-否;1-是
is_pre_downloadstring是否开启预下载,1-否;2-是
langstring语言
icon_urlstring图标url
icon_md5string图标md5
summarystring一句话简介
detail_descstring软件介绍
update_descstring版本说明
app_subnamestring应用副标题
test_descstring测试附加说明
video_urlstring视频地址
pic_urlstring竖屏截图地址
package_permission_descstring包权限描述
video_pic_urlstring视频封面地址
cover_urlstring游戏空间封面图
landscape_pic_urlstring横屏截图地址
privacy_source_urlstring隐私政策网址
release_descstring分阶段发布说明描述
test_urlstring测试文件
english_namestring英文名
regionstring地区
levelstring等级,-1-D;0-C;1-B;2-A
online_timedatetime上架时间
offline_timedatetime下架时间
is_first_publishstring是否首发
business_refuse_reasonstring商务审核打回理由
old_audit_statusstring
release_statusstring分阶段发布状态,0-未设置;1-分阶段发布中;2-暂停分阶段发布;3-取消分阶段发布;4-分布发布阶段结束
refuse_advicestring修改建议
statestring上架状态,1-上架;2-下架
change_statestring是否变更状态,-1-未请求变更;0-业务开启对外更新;1-取消预下载
online_info_offline_applyOfflineApplyInfo[]上架信息,结构参考OfflineApplyInfo
sizestringapk包大小
audit_statusstring审核状态
audit_status_namestring审核状态描述
offline_infostring下架申请信息
transfer_stateint转让状态,-1-无;1-审核通过;2-审核不通过;3-同意接受;4-不同意接受
update_info_checkint更新资料审核状态,1-审核中;0-不在审核中
level_tagstring应用等级标签
refuse_filestring打回附件链接
landscape_pic_url_materialPicMaterialInfo[]横屏截图扩展信息,结构参考PicMaterialinfo
pic_url_materialPicMaterialinfo[]竖屏截图扩展信息,结构参考PicMaterialinfo
video_url_materialVideoInfo[]视频扩展信息,接口参考VideoInfo
age_levelstringAPP年龄分级,示例:3
adaptive_equipmentstring平板适配,4-手机,5-平板,6-手机和平板
adaptive_typestring适配方式,1-平行视窗,2-横竖屏自适应适配
customer_contactstring,json字符串客服联系方式,示例:[{“contact_method”:“7”,“contact_info”:“点击客服头像Kate”,“working_hours”:“00:01-00:07”,“weekend_hours”:“00:23-01:14”}],

contact_method:联系方式,1-客服电话,2-客服邮箱,3-客服QQ号,4-客服QQ公众号,5-客服微信号,6-客服微信公众号,7-游戏内联系客服路径

contact_info:客服联系信息
working_hours:工作服务时间
weekend_hours:周末&节假日服务时间

OfflineApplyInfo

字段类型说明
app_idstring应用ID
version_idstring版本ID
online_statestring上架状态
online_timedatetime上架时间
offline_timedatetime下架时间

PicMaterialinfo

字段类型说明
urlstring图片地址
widthstring图片宽
heightstring图片高
md5string图片md5
sizestring图片大小

VideoInfo

字段类型说明
urlstring视频地址
md5string视频MD5值
sizeint视频文件大小
widthint视频尺寸:宽
heightint视频尺寸:高
fpsint视频帧率
durationint视频时长
definitionint视频码率

响应示例

成功示例

{
    "errno": 0,
    "data": {
        "app_id": "111",
        "pkg_name": "com.foo.bar",
        "type": 7,
        "sign": "38ee****057c",
        "dev_id": "1111",
        "app_key": "f429****efc6",
        "update_time": "2020年09月23日 19:31:05",
        "app_create_time": "2020-03-13 10:16:40",
        "app_name": "测试应用",
        "is_freeze": "0",
        "freeze_reason": null,
        "refuse_reason": "a:1:{i:0;s:24:\"资源下架理由外部\";}",
        "tag_list": null,
        "is_business": "0",
        "game_type": "0",
        "second_category_id": "74",
        "third_category_id": "6685",
        "copyright_url": "http://******2d877341.jpg,,",
        "special_url": "http://******520eabc9.jpg,,",
        "special_file_url": "",
        "freeze_file": null,
        "business_username": "",
        "business_email": "",
        "business_mobile": "",
        "business_qq": "",
        "business_position": "",
        "business_address": "",
        "freeze_advice": null,
        "app_type": "0",
        "app_real_type": "0",
        "electronic_cert_url": "",
        "icp_url": "",
        "relation_app_id": "0",
        "version_id": "111111",
        "version_code": "6091000",
        "version_name": "6.9.1",
        "apk_url": "/apk/202009/23/****eda24.apk",
        "apk_size": "70999067",
        "apk_md5": "0df6****0b53",
        "header_md5": "c3ab****e3ff",
        "package_permission": "android.permission.ACCESS_NETWORK_STATE",
        "resolution": null,
        "version_type": "2",
        "create_time": "2020-09-23 19:36:40",
        "ver_second_category_id": "74",
        "ver_third_category_id": "6685",
        "apk_full_url": "http://******/apk/202009/23/******eda24.apk",
        "online_type": "1",
        "sche_online_time": "2020-03-13 02:32:00",
        "test_type": "0",
        "test_start_time": "0000-00-00 00:00:00",
        "test_end_time": "0000-00-00 00:00:00",
        "player_customer_email": null,
        "player_customer_phone": null,
        "player_customer_qq": "",
        "is_signature": "0",
        "is_pre_download": "1",
        "icon_url": "http://******45cac481.png",
        "icon_md5": "",
        "summary": "xxxxxxxxxxxxxxxxxxxx",
        "detail_desc": "xxxxxxxxxxxxxxxxxxxxxxxx",
        "update_desc": "xxxxxxxxxxxxxxxxxxxxxxxx",
        "app_subname": "AppSubName",
        "test_desc": null,
        "video_url": "",
        "pic_url": "http://******edd338c7.jpg,http://******9dd7b7.jpg,http://******f00521.jpg",
        "package_permission_desc": null,
        "video_pic_url": null,
        "cover_url": null,
        "landscape_pic_url": "http://******10cb6c.jpg,http://******b6a908.jpg,http://******d720a9.jpg",
        "privacy_source_url": "http://foo.bar.com",
        "level": "1",
        "state": "1",
        "online_time": "2020-09-29 19:15:38",
        "offline_time": "2020-09-29 19:12:59",
        "business_refuse_reason": "a:1:{i:0;s:24:\"资源下架理由外部\";}",
        "online_info_offline_apply": [
            {
                "app_id": "111",
                "version_id": "111110",
                "online_state": "1",
                "online_time": "2020-09-29 19:13:07",
                "offline_time": "2020-09-29 17:00:19"
            },
            {
                "app_id": "111",
                "version_id": "111111",
                "online_state": "1",
                "online_time": "2020-09-29 19:15:38",
                "offline_time": "2020-09-29 19:12:59"
            }
        ],
        "size": "67.71 MB",
        "audit_status_name": "上线",
        "offline_info": null,
        "transfer_state": -1,
        "update_info_check": 0,
        "level_tag": "B",
        "refuse_advice": "a:1:{i:0;s:18:\"资源下架理由\";}",
        "refuse_file": "",
        "landscape_pic_url_material": [
            {
                "url": "http://******10cb6c.jpg",
                "width": "1915",
                "height": "1080",
                "md5": "06b9****6d1d",
                "size": "227502"
            },
            {
                "url": "http://******b6a908.jpg",
                "width": "1915",
                "height": "1080",
                "md5": "8fa1****c9e5",
                "size": "558801"
            },
            {
                "url": "http://******d720a9.jpg",
                "width": "1915",
                "height": "1080",
                "md5": "ee9e****ec32",
                "size": "350314"
            }
        ],
        "pic_url_material": [
            {
                "url": "http://******d338c7.jpg",
                "width": "1080",
                "height": "1920",
                "md5": "6c57****6148",
                "size": "396069"
            },
            {
                "url": "http://******9dd7b7.jpg",
                "width": "1080",
                "height": "1920",
                "md5": "f641****5f85",
                "size": "568491"
            },
            {
                "url": "http://******f00521.jpg",
                "width": "1080",
                "height": "1920",
                "md5": "f075****dffa",
                "size": "289818"
            }
        ],
        "video_url_material": [],
        "age_level": "3",
        "adaptive_equipment": "4",
        "adaptive_type": "1",
        "customer_contact": "[{\"weekend_hours\":\"09:30-18:00\",\"contact_method\":\"1\",\"working_hours\":\"08:30-18:30\",\"contact_info\":\"13928452035;95533\"},{\"weekend_hours\":\"00:00-23:59\",\"contact_method\":\"2\",\"working_hours\":\"08:30-18:30\",\"contact_info\":\"support@cat-studio.net;496228536@163.com\"},{\"weekend_hours\":\"09:30-18:00\",\"contact_method\":\"3\",\"working_hours\":\"08:30-18:30\",\"contact_info\":\"496228536;921440223\"},{\"weekend_hours\":\"09:30-18:00\",\"contact_method\":\"4\",\"working_hours\":\"08:30-18:30\",\"contact_info\":\"王者荣耀公众号123_honor\"},{\"weekend_hours\":\"09:30-18:00\",\"contact_method\":\"5\",\"working_hours\":\"08:30-18:30\",\"contact_info\":\"1bbb_235\"},{\"weekend_hours\":\"09:30-18:00\",\"contact_method\":\"6\",\"working_hours\":\"08:30-18:30\",\"contact_info\":\"吃鸡公众号_123child\"},{\"weekend_hours\":\"09:30-18:00\",\"contact_method\":\"7\",\"working_hours\":\"08:30-08:00\",\"contact_info\":\"13928452035字汉字汉字汉字汉字汉字汉字汉字汉字汉字汉字汉字汉字\"}]"
    }
}

失败示例

{
    "errno": 911045,
    "data": {
        "message": "开发者ID和包名不匹配",
        "logid": 2204318265
    }
}

OPPO开放平台API传包能力接入 更新资料

更新说明

更新时间更新说明
2022-06-08请求参数新增customer_contact;请求参数删除player_customer_email、player_customer_phone、player_customer_qq、ascription_type、proxy_contract_url、authorize_type、authorize_url、authorize_desc、approval_doc_number、approval_doc_type、approval_doc_start_time、approval_doc_end_time、approval_doc_url、culture_record_number、culture_record_url、operation_license_url、absolve_declare_url;请求参数summary不能多于13个字

接口功能

此接口用于更新资源相关信息,不会新增版本。

接口处理可能会比较耗时,建议客户端执行等待时间设置为10秒以上。

接口原型

-请求路由:/resource/v1/app/updm
-请求方法:POST
-请求类型:Content-Type: x-www-form-urlencoded

请求参数

参数名称参数类型是否必传适用资源类型(无说明则都适用)备注
pkg_namestring必传应用包名
version_codestring必传版本号
app_subnamestring非必须合作游戏副标题,1-10 个字符,不得包含空格等特殊字符
summarystring必传一句话简介,不多于 15 个字符,不能包含任何标点符号和空格
detail_descstring必传软件介绍,不少于 20 个字
update_descstring必传版本说明,不少于 5 个字
privacy_source_urlstring必传隐私政策网址
icon_urlstring必传图标 url,尺寸:512*512px,图片格式:png,小于 1M
pic_urlstring必传竖版截图 url,多个用英文逗号分隔,不能少于两张,上传 3-5 张截图,支持 jpg、png 格式。 截图尺寸要求:1080*1920,单张图片不能超过 1M
landscape_pic_urlstring非必传横版截图 url,多个用英文逗号分隔,上传 3-5 张截图,支持 jpg、png 格式。 截图尺寸要求:1915*1080,单张图片不能超过 1M
video_urlstring非必传游戏宣传视频地址,小于 30MB,支持格式:MP4
video_url_materialVideoInfo[]非必传视频扩展信息,请求时需转换成json格式,格式参考VideoInfo
test_descstring必传测试附加说明,最多输入 400 个字符
electronic_cert_urlstring非必传电子版权证书,上传 PDF 格式文件,不能超过 20MB
copyright_urlstring必传应用、合作应用软件版权证明
icp_urlstring非必传应用、合作应用ICP 备案网址或备案号
special_urlstring非必传应用、合作应用特殊类证书,支持 jpg、png 格式的图片,每张图片大小不超过 1M
special_file_urlstring非必传应用、合作应用特殊类证书压缩包,支持 rar、zip 格式的文件,大小不能超过 30M
video_pic_urlstring非必传合作游戏游戏宣传视频横屏封面图,尺寸:1080*594px,图片格式:jpg/png,小于 1M
cover_urlCoverURLInfo必传合作游戏游戏空间封面图,请求时需转换成json格式,结构参考 CoverURLInfo
record_identification_codestring非必传合作游戏备案识别码,有版号时必填,10 位数字
record_identification_imagestring非必传合作游戏渠道绑定截图,有版号时必填,jpg/png 格式的图片,大小不超过 1M
other_cetificate_urlstring非必传合作游戏其他补充资质,支持 zip 格式,大小不超过 30M
business_usernamestring必传商务联系人姓名
business_emailemail必传商务联系人邮箱
business_mobilestring必传商务联系人电话
business_qqstring非必传合作游戏商务联系人 QQ
business_positionstring非必传合作游戏商务联系人职务
business_addressstring非必传合作游戏商务联系人办公地址
customer_contactstring,json字符串必传合作游戏客服联系方式,示例:[{“contact_method”:“7”,“contact_info”:“点击客服头像Kate”,“working_hours”:“00:01-00:07”,“weekend_hours”:“00:23-01:14”}],

contact_method:联系方式,1-客服电话,2-客服邮箱,3-客服QQ号,4-客服QQ公众号,5-客服微信号,6-客服微信公众号,7-游戏内联系客服路径

contact_info:客服联系信息
working_hours:工作服务时间
weekend_hours:周末&节假日服务时间

VideoInfo

-可从文件上传接口获取

字段类型说明
urlstring视频地址
md5string视频MD5值
sizeint视频文件大小
widthint视频尺寸:宽
heightint视频尺寸:高
fpsint视频帧率
durationint视频时长
definitionint视频码率

CoverURLInfo

字段类型说明
hmap横版封面,包含一个图片 url 字段,尺寸:939*507px,图片格式:jpg/png,小于 1M
vmap竖版封面,包含一个图片 url 字段,尺寸:756*1080px,图片格式:jpg/png,小于 1M

结构示例:

{
    "v":{
        "url":"http://******4494fa0b.jpg"
    },
    "h":{
        "url":"http://******80b90afc.jpg"
    }
}

请求响应

响应说明

字段类型说明
errnoint错误码,为 0 表示请求正常
dataUpdBody响应体,结构参考 UpdBody

UpdBody

字段类型说明
successboolen请求成功时返回,必为 true
messagestring响应信息,请求失败时会返回错误信息说明
logidint请求ID

响应示例

成功示例

{
    "errno":0,
    "data":{
        "success":true,
        "message":""
    }
}

失败示例

{
    "errno":800002,
    "data":{
        "message":"包名不能为空",
        "logid":3906849174
    }
}

OPPO应用商店介绍 OPPO软件商店介绍

OPPO应用商店介绍 OPPO软件商店介绍

简介

软件商店是官方、正版、安全的APP下载渠道,拥有海量资源,所有资源都通过机器检测、人工亲测,为用户提供安全可靠的应用、游戏资源下载及管理功能。

安心下 放心用
为开发者提供优质服务,成为开发者必选和新产品独家首发的平台。
为用户提供安全、优质的内容,成为用户首选的软件商店。

优势

强大的分发能力
国内最大的移动分发渠道之一,以 oppo 亿级用户为基础,提供强大的平台分发能力。

公开的生态资源
创建健康公平的应用生态,帮助开发者将优质内容提供给用户,帮助用户发现优质内容。

便捷的开发者服务
全面开放账号、支付、数据分析等产品服务,并配置强大的人工审核团队,确保资源快速上线。