# CPS组件API开发接入文档
基础库 3.8.6 开始支持，低版本需做兼容处理
# 一、组件概览
CPS组件需3 樱花视频在线，8，6及以上基础库版本支持，基于 PageManager 能力。 CPS组件分为「单游戏组件、多游戏组件、游戏橱窗」三种，mp端配置后均可使用API创建。。
从左往右依次是「单游戏组件 樱花视频高清. 多游戏组件. 游戏橱窗」.
# 1. 输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Object.id | string | 是 | 必选，填入mp端配置的组件ID |
| Object.left | number | 否 | 可选，组件左上角屏幕横坐标 单游戏组件/多游戏组件时有效 不填时平台将自动适应游戏类型并展示 |
| Object.top | number | 否 | 可选，组件左上角屏幕纵坐标 单游戏组件/多游戏组件时有效 不填时平台将自动适应游戏类型并展示 |
| Object.isVertical | boolean | 否 | 可选，当为「多游戏组件」时，可以选择「水平展示/竖直展示」，默认为false |
| Object.query | object | 否 | 可选，打开CPS游戏时传入的启动query参数 |
# 2. 监听事件
| 回调类型 | 回调时机 | 返回 | 备注 |
|---|---|---|---|
| ready | 组件加载完毕时触发 | - | - |
| show | 用户侧展示组件时触发 | - | - |
| destroy | 用户关闭组件时触发 | - | - |
| clickgame | 用户点击组件中的CPS游戏时触发 | Object | 从CPS游戏返回后触发 |
| error | 组件发生错误时触发 | Object | - |
clickgame callback回调返回：
| 返回参数 | 类型 | 说明 |
|---|---|---|
| Object.targetGameName | string | 表示玩家点击的CPS游戏的名称 |
error callback 回调返回：
| 返回参数 | 类型 | 说明 |
|---|---|---|
| Object.errCode | number | 错误码 |
| Object.errMsg | string | 调用时返回的错误消息 ● 当前广告ID不可用 ● 暂无CPS推荐组件调用权限 ● 其他组件错误信息 |
# 3. 组件尺寸
ratio = 屏幕宽度 / 414
温馨提示：注意组件尺寸 樱花视频免费观看，避免显示超过组件屏幕.
单游戏组件：
宽度 = 80 * ratio
高度 = 100 * ratio;
多游戏组件：
横版：
宽度 = 312 * ratio
高度 = 112 * ratio
竖版：
宽度 = 56 * ratio
高度 = 305 * ratio
樱花视频免费观看 - # 二、最佳实践
# 1. 获取实例
___JX5_PROTECTED_code_2___
# 2. 预加载
___JX5_PROTECTED_code_3___
# 3. 展示 (樱花视频免费观看)
注意：若未进行预加载会首先进行预加载
___JX5_PROTECTED_code_4___
# 4. 销毁
___JX5_PROTECTED_code_5___
# 5. 监听事件
___JX5_PROTECTED_code_6___