Skip to content

sud.getContainerInfo ​

同步获取 OP 的容器尺寸信息和设备像素比,可用于游戏布局时读取逻辑宽高。无参数,不返回 Promise。

返回值 ​

Object

属性类型说明
containerWidthnumber逻辑宽度,Android 为 dp,iOS 为 pt
containerHeightnumber逻辑高度,Android 为 dp,iOS 为 pt
pixelRationumber设备像素比;无法获取有效值时返回 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 的 style.left/top/width/height、style.realWidth/realHeight 及 onResize 返回的宽高都使用逻辑像素,直接使用即可;不要再乘或除 pixelRatio。调用 sud.createBannerAd 时传入游戏实际为广告预留的区域。