object:setNativeProperty()

类型 函数
对象 NativeDisplayObject
库 native.*
返回值 无
修订版 2024.3703 版
关键字 原生对象、属性访问器
参见 object:getNativeProperty()

概述

此函数允许您设置由 native 库创建的底层原生对象属性。例如，如果您在 iOS 上创建 WebView，则可以在发出请求之前，设置与 WKWebView 或 WKWebViewConfiguration 相对应的 Obj-C 属性。同样，在 Android 上，它可以设置 WebView 或 WebSettings 的属性

语法

object:setNativeProperty( property, value )
属性 （必需）

字符串.原生属性的字符串名称。

值 （必需）

设置属性的值。必须与以下内容兼容的 Lua 值Obj-C或 Java。以下 Lua 值将转换为在Obj-C: 布尔值、字符串、数组、表 和 数字 中相应的数值。Java 支持的类型是 布尔值、字符串 和 数字。

Android 还支持 Web 视图的一对特殊值：属性 “http.agent” 和值 “system”，用于将 Web 视图用户代理设置为系统的默认值。

示例

local webView = native.newWebView( 0, 0, display.contentWidth, display.contentHeight )
if system.getInfo("platform") == "android" then
    webView:setNativeProperty("http.agent", "system")
    webView:setNativeProperty("setBuiltInZoomControls", false)
else
    webView:setNativeProperty( "allowsInlineMediaPlayback", true )
end
webView:request( "https://www.solar2d.com" )