开发进阶教程更新时间：2025-08-11 17:54:00
1.开发及调试进阶
- 小米快游戏接入了更多小米API需要在小米开发者平台上传游戏，联盟快游戏针对快游戏联盟统一了API接口和包体可以选择在联盟开发者平台或者小米开发者平台进行游戏上传。如果需要使用微转小功能可以使用联盟开发者工具
- 目前小米快游戏不支持云测，仅支持安装快应用调试器调试。具体联调自测操作详见：
- 未完成审核上架时，开发者可以使用米盟提供的测试广告位，进行广告接入测试，提升接入效率。测试广告位填充率高，利于调试验证，但不计费。
- 小游戏技术常见问题（FAQ）
- 版本说明：
小米线上存在webview和runtime两种运行环境，开发者可以针对运行环境的进行打包进行最优策略匹配，为线上用户带来最优体验，小米线上从1309版本允许双包并存。
| 包体类型 | 打包方式 | 最小框架版本限制 | 优势 |
| 小米webview | unity/cocos引擎直接打包 | 1060 | 版本覆盖度高 |
| 小米runtime | 小米打包工具打包 | 1308.3 | 包体整体变小，启动时长缩短约10% |
| 联盟runtime | 联盟打包工具打包 | 1308.3 | 包体整体变小，启动时长缩短约10% |
2.广告进阶教程
- 广告位创建
- 米盟快游戏不支持H5媒体，且在创建广告位时无需选择接入方式
- 米盟现仅支持模板广告，如您需使用自渲染广告类型，请联系区域商务
- 米盟广告位不支持直接删除操作，但您可以通过点击广告位上的【关闭】按钮来暂停使用该广告位
- 域名配置：小游戏上架过程中没有域名相关配置，接入SDK后即可正常上架。
- 广告接入
| 维度 | 广告样式 | 核心关注点 |
| 支持的广告类型 | - banner广告 - 插屏广告 - 激励视频广告 - 激励广告 - 原生模板广告 - 开屏广告 - 互推盒子广告 | - 小米额外支持激励广告样式 - 开屏广告，小米不支持通过类似wx.getShowSplashAdStatus(Object object)的方法获取广告展示状态 - 小米的互推盒子广告通过api接入，样式更丰富，适用场景更多 |
| 开屏广告 | - 支持类型：竖版系统开屏、横版开屏 - 调用方式：开发者只需启用广告位，无需调用 - 数据加载： 1、竖版系统开屏：系统级应用跨进程加载； 2、横版开屏：当前进程当前Activity加载。 - 广告渲染： 1、竖版系统开屏：系统级Window层渲染； 2、横版开屏：当前Activity渲染。 - 数据加载和渲染时机：快游戏框架控制，开发者无法控制 | - 小米同时支持竖版、横版开屏广告 - 小米竖版系统开屏广告，跨进程加载数据、在系统级Window层渲染 - 小米横版开屏广告在当前进程当前Activity加载、渲染数据 - 注意：系统开屏相关说明 1、竖版专用（系统开屏无需接入和测试，媒体通过审核后自动生效）； 2、广告覆盖所有小米用户需要24小时，即刚下载的应用，最长需要24小时才会显示广告； 3、初次启用系统开屏广告位时，会在启用的次日7：00AM开始展示广告（若开发者预在T日开始展示广告，则需在T-1日于米盟后台对应广告位处点击“启用”广告，否则会延迟一天开始展示广告）； 4、非初次启用环境中，从暂停状态改为启用状态，系统会在启用后的1-2小时开始展示广告。 5、需正确使用开屏广告，竖版选择系统开屏，横版选择应用内开屏-横版，广告方向需与应用方向一致。 |
| 数据加载 | - 时机控制：除开屏广告外，其他广告数据加载时机由开发者控制 - 实现方式：由快游戏框架实现数据加载 | - 小米是由系统级应用“快游戏框架”实现广告数据加载 |
| 广告渲染 | - 时机控制：除开屏广告外，其他广告渲染时机由开发者控制 - 实现方式：由快游戏框架实现广告渲染 | - 小米是由系统级应用“快游戏框架”实现广告渲染 |
| 广告链路 | - 开发者调用api加载广告 - 快游戏框架加载数据 - 开发者调用api展示广告 - 快游戏框架渲染广告 | - 小米是由系统级应用“快游戏框架”支持广告能力，负责数据加载和广告渲染 |
| 主动方法 | - load - show - hide - destroy | - 不同的广告样式，支持的主动方法不一致，具体需参照api文档 |
| 回调 | - offShow - onError - offError - onLoad - offLoad - onClose - offClose - onClick - offClick - onResize - offResize | - 小米额外支持点击展示、点击回调；只对banner广告类型支持尺寸缩放回调 |
- 广告变现常见问题排查
| 问题类型 | 问题描述 | 问题原因 | 解决方案 |
| 错误码 | 开发者在广告调试、线上广告变现的过程中，可能会收到错误回调，包括错误信息和错误码。或者在SSP平台的填充率诊断模板看到错误码及对应说明。 | - 针对异常情况，客户端、服务端会返回错误信息、错误码，在onError中回调给开发者，或在SSP平台公布。 - 在onError中回调的客户端错误码主要涉及接入问题；在SSP平台公布的服务端错误码主要涉及流量变现问题。 | - 开发者可以根据接入文档和SSP平台的错误码列表及调优建议，尝试自行分析、解决问题。 - 若无法解决，可以在米盟开放平台提交工单反馈或联系对接的开发者运营。 - 后续小米广告联盟会对错误码列表、错误码含义、排查建议等错误码相关内容进行更新优化。 |
| 数据问题 | 开发者查看SSP平台的变现数据时，发现某项数据指标异常变化，例如曝光数据突然降低。 | - 统计口径不同。如果开发者有自行统计请求、曝光等数据，发现和SSP平台的变现数据有gap，可能是数据统计口径不同导致的。一定的数据gap是正常现象，如果gap过大，请联系米盟解决。 - 开发者策略调整。开发者的广告策略和逻辑会直接影响数据结果，如果开发者进行了版本更新或者广告策略调整（例如采取了预加载策略），会对曝光等数据有影响。 | - 建议开发者先自查广告请求、展示逻辑，尽量在合理的业务场景下请求广告，特殊逻辑会导致数据异常。例如相同场景同时用多个upid请求广告，但最后只曝光一个，会影响填充率、曝光率的数据表现。 - 若仍有问题，可以在米盟开放平台提交工单反馈或联系对接的开发者运营。 |
| 广告接入问题 | 开发者尝试接入米盟广告，进行调试时，遇到接入报错或异常。例如未返回广告、代码报错、回调缺失等情况。 | - 应用/广告位状态问题：例如应用未审核通过、整改封禁中、灰度中；广告位新创建等。 - 开发者代码逻辑问题：upid拼写错误、错误使用api方法等。 - 米盟广告的功能问题。 | - 建议开发者先参照广告接入文档排查代码逻辑问题。 - 若仍有问题，可以在米盟开放平台提交工单反馈或联系对接的开发者运营。 |
| 广告展示问题 | 开发者接入米盟广告，在调试环节或者线上，米盟广告展示异常，例如展示不全，横向/纵向截断。 | - 开发者设置的广告组件的宽高值不正确，导致广告组件和广告内容之间出现尺寸冲突。 - 不同机型的分辨率不同，组件的宽高值单位设置有误 - 米盟广告的功能问题。 | - 建议开发者先调整广告组件宽高值进行调试，推荐设置固定宽度，高度自适应。同时注意px、dp单位问题，考虑在不同机型上的适配。 - 如果自行调试仍有问题，可以在米盟开放平台提交工单反馈或联系对接的开发者运营，寻求技术支持。 |
| 广告功能bug | 开发者可能通过数据分析、接受用户反馈等方式发现了疑似米盟广告功能bug。 | - 当前版本的米盟广告存在一些bug。 | - 请立即在米盟开放平台提交工单反馈或联系对接的开发者运营，小米广告联盟会高优排查问题并给出修复方案。 |
| 版本/设备兼容问题 | 开发者发现了一些广告接入、展示、功能问题，仅在特定快游戏框架版本和机型上出现 | - 版本兼容问题，一般是低框架版本存在一些bug，或者新功能未覆盖低框架版本。 - 设备兼容问题，一般是一些特殊机型，例如折叠屏、pad会出现。 | - 尽可能更新框架版本，高版本的快游戏框架对已知问题进行了修复，且能够支持更多新功能。 - 设备兼容及其他兼容问题可以通过工单和开发者运营寻求技术支持，后续会排期优化适配。 |
- 广告变现常见问题FAQ
1.Q：两次广告请求间隔时长是否有明确要求？
A:有。同类型广告两次请求之间要大于30s。
2.Q：游戏支持横竖屏自由切换，但广告位只能固定创建为横版或竖版，会不会导致广告展示异常？
A:米盟广告API不会对横竖屏广告做强制适配。若游戏在横竖屏间切换，需由开发者自行处理屏幕方向，确保广告正常展示。
3.Q：Banner 横幅广告首次 show() 正常，hide() 后再次 show() 不再展示，是否每次 hide 后都要重新创建？
A:hide() 与 destroy() 逻辑一致，调用 hide() 即视为销毁广告。如需再次展示，必须重新创建 Banner 实例。
文档内容是否有帮助？
有帮助
无帮助