异形屏信息获取
在Android设备上,获取异形屏的刘海高度、挖孔高度、异形屏区域等信息,用于适配异形屏。确保应用内容显示不被遮挡。
常用场景:
- 界面布局适配:获取屏幕安全区域,调整游戏HUD、按钮等界面元素的摆放位置,避免界面元素被遮挡。
- 游戏内容适配:在游戏场景中,根据异形屏数据调整摄像机位置、角色位置等,确保场景对象不被遮挡。
- 横竖屏切换处理:当屏幕旋转时重新获取异形屏数据,确保不同方向下的布局都能正确避开异形区域。
note
该接口仅针对 Android 设备, 且是异步调用。
客户端 API
回调接口
Player Network SDK 工具模块的回调接口,请参见:
- Unity
- Unreal Engine
| API | 函数定义 |
|---|---|
| AddCutoutInfoObserver | 注册 Player Network SDK 异步异形屏信息获取接口 CutoutInfoResult 的回调。用于处理 LoadCutoutData 接口的回调。 |
| RemoveCutoutInfoObserver | 注销 CutoutInfoResult 的回调。 |
| API | 函数定义 |
|---|---|
| SetCutoutInfoObserver | 设置 Player Network SDK 异步异形屏信息获取接口 CutoutInfoResult 的回调。 |
| GetCutoutInfoObserver | 获取 CutoutInfoResult 的回调。 |
| OnCutoutResult_Implementation | 实现 LoadCutoutData 接口的 CutoutInfoResult 的回调。 |
工具 API
有关 Player Network SDK 的工具接口,请参见:
- Unity
- Unreal Engine
| API | 函数定义 |
|---|---|
| LoadCutoutData | 屏幕发生转动时,需要重新获取转动后异形屏信息 |
| API | 函数定义 |
|---|---|
| LoadCutoutData | 屏幕发生转动时,需要重新获取转动后异形屏信息 |