display.getSafeAreaInsets()

类型 函数
display.*
返回值 数字
版本 Release 2024.3703
关键字 安全区域、嵌入式
另请参阅 display.safeScreenOriginX
display.safeScreenOriginY
display.safeActualContentWidth
display.safeActualContentHeight

概述

返回与顶部、左侧、底部和右侧“安全区域”内嵌式相对应的四个数字。“安全区域”是放置重要的 UI 元素的安全矩形区域,确保它们不会被状态栏、传感器栏或圆角、软件按钮、电视扫描过度区域等设备外形遮挡。

实质上,这些内嵌式值表示内容单元中相应屏幕边缘与此类元素不会干扰或遮挡屏幕内容的假想边界线之间的距离。

语法

display.getSafeAreaInsets()

示例

-- Gather insets (function returns these in the order of top, left, bottom, right)
local topInset, leftInset, bottomInset, rightInset = display.getSafeAreaInsets()

-- Create a vector rectangle sized exactly to the "safe area"
local safeArea = display.newRect(
    display.screenOriginX + leftInset, 
    display.screenOriginY + topInset, 
    display.actualContentWidth - ( leftInset + rightInset ), 
    display.actualContentHeight - ( topInset + bottomInset )
)
safeArea:translate( safeArea.width*0.5, safeArea.height*0.5 )