sud.getContainerInfo
同步获取 OP 的容器尺寸信息和设备像素比,可用于游戏布局时读取逻辑宽高。无参数,不返回 Promise。
返回值
Object
| 属性 | 类型 | 说明 |
|---|---|---|
| containerWidth | number | 逻辑宽度,Android 为 dp,iOS 为 pt |
| containerHeight | number | 逻辑高度,Android 为 dp,iOS 为 pt |
| pixelRatio | number | 设备像素比;无法获取有效值时返回 1 |
使用说明
containerWidth/containerHeight返回的是游戏容器的实际逻辑尺寸。游戏不一定全屏展示(例如嵌入式、分屏场景),容器尺寸可能小于屏幕尺寸,因此与 sud.getWindowInfo 返回的screenWidth/screenHeight/windowWidth/windowHeight不通用,游戏布局和广告定位应以容器尺寸为准。pixelRatio返回设备像素比,与 sud.getWindowInfo 返回的pixelRatio值一致,可通用。
示例代码
javascript
const { containerWidth, containerHeight, pixelRatio } = sud.getContainerInfo();
console.log('Container logical size', containerWidth, containerHeight);
console.log('Device pixel ratio', pixelRatio);Banner 尺寸使用
Banner 的 style.left/top/width/height、style.realWidth/realHeight 及 onResize 返回的宽高都使用逻辑像素,直接使用即可;不要再乘或除 pixelRatio。调用 sud.createBannerAd 时传入游戏实际为广告预留的区域。
