宜信同城网交流论坛技术专版技术专区Native.js for iOS封装一条通过JS语法直接调用Native Objective-C接口通道，通过plus. ...方法： importClass: 导入Objective-C类对象newObject: 创建实例对象deleteObject: 销毁实例对象invoke: ...

admin 发表于 2023-2-16 18:54:41

Native.js for iOS封装一条通过JS语法直接调用Native Objective-C接口通道，通过plus. ...

<div id="article_content" class="article_content clearfix">
 <link rel="stylesheet" href="https://csdnimg.cn/release/blogv2/dist/mdeditor/css/editerView/kdoc_html_views-1a98987dfd.css">
 <link rel="stylesheet" href="https://csdnimg.cn/release/blogv2/dist/mdeditor/css/editerView/ck_htmledit_views-6e43165c0a.css">
 <div id="content_views" class="htmledit_views">
 <h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841569#plus.ios.importClass">importClass</a>: 导入Objective-C类对象</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841569#plus.ios.newObject">newObject</a>: 创建实例对象</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841569#plus.ios.deleteObject">deleteObject</a>: 销毁实例对象</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841569#plus.ios.invoke">invoke</a>: 调用对象（类对象/示例对象）的方法</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841569#plus.ios.implements">implements</a>: 实现代理的方法</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841569#plus.ios.currentWebview">currentWebview</a>: 获取当前Webview窗口对象的native层UIWebview实例对象</li></ul>
<h2 style="margin-left:.8em;">对象：</h2>
<ul><li><ahref="https://www.html5plus.org/doc/zh_cn/ios.html#plus.ios.ClassObject">ClassObject</a>: Objective-C类对象</li><li><ahref="https://www.html5plus.org/doc/zh_cn/ios.html#plus.ios.InstanceObject">InstanceObject</a>: Objective-C实例对象</li></ul>
<h2 style="margin-left:.8em;">权限：</h2>
5+功能模块（permissions）
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
{
// ...
"permissions":{
// ...
"Invocation": {
"description": "Native.js"
}
}
}
</code></code></pre>
<h1 style="margin-left:0;">importClass</h1>
导入Objective-C类对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
ClassObject plus.ios.importClass( String classname );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
导入类对象后，就可以通过.操作符直接调用对象（类对象/实例对象）的方法。通过.操作符号调用方法时，不需要使用":"来分割参数。注意：导入类对象将会消耗较多的系统资源，不应该导入过多的类对象，可以使用plus.ios.invoke()来调用未导入类实例对象的方法。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>classname: ( String | <ahref="https://www.html5plus.org/doc/zh_cn/ios.html#plus.ios.InstanceObject">InstanceObject</a> ) 必选 要导入的Objective-C类名 如果指定的类名不存在，则导入类失败，不会抛出异常。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/ios.html#plus.ios.ClassObject">ClassObject</a> : Objective-C类对象，如果导入类对象失败则返回null。
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
<title>iOS Native.js</title>
<script type="text/javascript">
// 监听plusready事件
document.addEventListener( "plusready", function(){
// 扩展API加载完毕，现在可以正常调用扩展API
// 导入GKLocalPlayer
var GKLocalPlayer= plus.ios.importClass("GKLocalPlayer");
}, false );
</script>
</head>
<body>
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">newObject</h1>
创建实例对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
InstanceObject plus.ios.newObject( String classname, Object..args );
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>classname: ( String ) 必选 要创建实例对象的类名 如果指定的类名不存在，则创建对象失败，不会抛出异常。 </li><li>args: ( Object ) 可选 创建实例对象的构造参数 如果指定的构造参数类型不区配，则创建对象失败，不会抛出异常。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/ios.html#plus.ios.InstanceObject">InstanceObject</a> : Objective-C实例对象，如果创建对象失败则返回null。
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
<title>iOS Native.js</title>
<script type="text/javascript">
// 监听plusready事件
document.addEventListener( "plusready", function(){
// 扩展API加载完毕，现在可以正常调用扩展API
// 创建GKLocalPlayer类的一个实例对象
var localplayer= plus.ios.newObject("GKLocalPlayer");
}, false );
</script>
</head>
<body>
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">deleteObject</h1>
销毁实例对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.ios.deleteObject( Object obj );
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>obj: ( Object ) 必选 要销毁的实例对象 如果obj对象不是有效的实例对象，则不执行销毁对象操作，不会抛出异常。如果不执行销毁实例对象操作，在页面关闭时会自动执行销毁对象的操作。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
<title>iOS Native.js</title>
<script type="text/javascript">
// 监听plusready事件
document.addEventListener( "plusready", function(){
// 扩展API加载完毕，现在可以正常调用扩展API
// 创建GKLocalPlayer类的一个实例对象
var localplayer= plus.ios.newObject("GKLocalPlayer");
// ...
// 销毁GKLocalPlayer示例对象
plus.ios.deleteObject( localplayer );
}, false );
</script>
</head>
<body>
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">invoke</h1>
调用对象（类对象/示例对象）的方法
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
Object plus.ios.invoke( Object obj, String name, Object... args );
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>obj: ( <ahref="https://www.html5plus.org/doc/zh_cn/ios.html#plus.ios.InstanceObject">InstanceObject</a> | <ahref="https://blog.csdn.net/qq_40575646/article/details/122841569#plus.ios.ClassObject">ClassObject</a> | String ) 必选 调用方法所属的对象，也可以是类的名称 如果obj为实例对象（InstanceObject）类型，则调用的是实例对象的方法； 如果obj为类对象（ClassObject）类型，则调用的是类的静态方法； 如果obj为字符串（String）类型，其值必须是类的名称，则调用的是类的静态方法； </li><li>name: ( String ) 必选 要调用的方法名称 方法名称中使用":"分隔参数。如果指定的方法名称不存在，则调用方法失败，不会抛出异常。 </li><li>args: ( Object ) 可选 调用方法的参数 如果指定的参数数目或类型不区配，则调用方法失败，不会抛出异常。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
Object : 调用方法的返回值，如果调用方法失败，则返回null。
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
<title>iOS Native.js</title>
<script type="text/javascript">
// 监听plusready事件
document.addEventListener( "plusready", function(){
// 扩展API加载完毕，现在可以正常调用扩展API
　　// 创建UIAlertView类的实例对象
　　var view = plus.ios.newObject("UIAlertView");
　　// 设置提示对话上的内容，这里的方法名称中必须包含':'字符
　　plus.ios.invoke(view,"initWithTitle:message:delegate:cancelButtonTitle:otherButtonTitles:"
　　 , "自定义标题" // 提示框标题
　　 , "使用NJS的原生弹出框，可自定义弹出框的标题、按钮"// 提示框上显示的内容
　　 , null // 操作提示框后的通知代理对象，暂不设置
　　 , "确定(或者其他字符)" // 提示框上取消按钮的文字
　　 , null ); // 提示框上其它按钮的文字，设置为null表示不显示
　　// 调用show方法显示提示对话框，在JS中使用()语法调用对象的方法
　　plus.ios.invoke(view,"show");
}, false );
</script>
</head>
<body>
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">implements</h1>
实现代理的方法
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
InstanceObject plus.ios.implements( String name, Object obj );
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>name: ( String ) 必选 代理的名称，也可以是自定的字符串名称 如果name为自定的字符串名称，则自定义一个代理； </li><li>obj: ( Object ) 必选 JSON对象类型，代理实现方法的定义 JSON对象中key值为代理方法的名称，使用":"分割参数；value值为Function，方法参数必须与代理方法中的":"区配。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/ios.html#plus.ios.InstanceObject">InstanceObject</a> : 代理实例对象。
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
<title>iOS Native.js</title>
<script type="text/javascript">
// 监听plusready事件
document.addEventListener( "plusready", function(){
// 扩展API加载完毕，现在可以正常调用扩展API
// 登录到游戏中心
// 监听用户登录状态变更事件
var nc = NSNotificationCenter.defaultCenter();
if(delegate){
nc.removeObservernameobject(delegate,"GKPlayerAuthenticationDidChangeNotificationName",null);
}
delegate = plus.ios.implements("NSObject",{"authenticationChanged:":authenticationChanged});
nc.addObserverselectornameobject(delegate,
plus.ios.newObject("@selector","authenticationChanged:"),
"GKPlayerAuthenticationDidChangeNotificationName",
null);
// 获取游戏玩家共享实例对象
var localplayer = GKLocalPlayer.localPlayer();
// 判断游戏玩家是否已经登录认证
if ( localplayer.plusGetAttribute("isAuthenticated") ) {
 // 玩家已登录认证，获取玩家信息
 playerInformation( localplayer );
 bLogin = true;
} else {
 // 玩家未登录认证，发起认证请求
 localplayer.authenticateWithCompletionHandler(null);
 eStart.innerText = "登录中...";
}
// 释放使用的对象
plus.ios.deleteObject(localplayer);
plus.ios.deleteObject(nc);
}, false );
</script>
</head>
<body>
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">currentWebview</h1>
获取当前Webview窗口对象的native层UIWebview实例对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
InstanceObject plus.ios.currentWebview();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
UIWebview对象的API请参考Apple开发文档
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
<ahref="https://blog.csdn.net/qq_40575646/article/details/122841569#plus.ios.InstanceObject">InstanceObject</a> : Webview窗口对象的native层实例对象，如果调用方法失败，则返回null。
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
<title>iOS Native.js</title>
<script type="text/javascript">
var nwv=null;
// 监听plusready事件
document.addEventListener( "plusready", function(){
// 扩展API加载完毕，现在可以正常调用扩展API
// 获取当前Webview窗口的UIWebview实例对象
nwv = plus.ios.currentWebview();
// ...
}, false );
// 使用Native.js调用Webview的loadUrl方法跳转页面
function loadUrl(){
// 导入UIWebview、NSURLRequest、NSURL类
var Webview = plus.ios.importClass("UIWebview");
var NSURLRequest = plus.ios.import('NSURLRequest');
var NSURL = plus.ios.import('NSURL');
// 获取当前Webview对象的实例
var wv = plus.ios.currentWebview();
// 创建请求对象
var req = NSURLRequest.requestWithURL(NSURL.URLWithString('http://www.dcloud.io/'));
// 跳转页面
plus.ios.invoke(wv,"loadRequest:",req);
// 释放对象(可选)
plus.ios.deleteObject(req);
plus.ios.deleteObject(wv);
}
</script>
</head>
<body>
获取当前Webview窗口对象的native层UIWebview实例对象 
<button onclick="loadUrl()">Native.js跳转页面</button>
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">ClassObject</h1>
Objective-C类对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface ClassObject {
// ...
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Objective-C类对象，可通过其属性获取类的常量，可通过方法来操作类的静态方法，也通过new方法来创建类的实例对象。对于类的静态方法，则直接通过.后面跟随方法名称调用。
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
<title>iOS Native.js</title>
<script type="text/javascript">
// 监听plusready事件
document.addEventListener( "plusready", function(){
// 扩展API加载完毕，现在可以正常调用扩展API
// 调用ios的文字转语音
var AVSpeechSynthesizer = plus.ios.importClass("AVSpeechSynthesizer");
var sppech = new AVSpeechSynthesizer(); // 实例化AVSpeechSynthesizer类对象
// ...
}, false );
</script>
</head>
<body>
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">InstanceObject</h1>
Objective-C实例对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface InstanceObject {
// ...
function Object plusGetAttribute( String name );
function Object plusSetAttribute( String name, Object value );
// ...
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Objective-C实例对象，可通过其方法来操作示例的变量和方法。注意：必须通过plusGetAttribute()方法读取示例对象的属性值，通过plusSetAttribute()方法设置示例对象的属性值。
<h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841569#plus.ios.InstanceObject.plusGetAttribute">plusGetAttribute</a>: 获取Objective-C实例对象的属性</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841569#plus.ios.InstanceObject.plusSetAttribute">plusSetAttribute</a>: 设置Objective-C示例对象的属性</li></ul>
<h1 style="margin-left:0;">plusGetAttribute</h1>
获取Objective-C实例对象的属性
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
Object insobj.plusGetAttribute( String name );
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>name: ( String ) 必选 实例属性的名称 如果指定的属性名称不存在，则返回null。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
Object : 属性的实例对象
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
<title>iOS Native.js</title>
<script type="text/javascript">
// 监听plusready事件
document.addEventListener( "plusready", function(){
// 扩展API加载完毕，现在可以正常调用扩展API
// 登录到游戏中心
// 监听用户登录状态变更事件
var nc = NSNotificationCenter.defaultCenter();
if(delegate){
nc.removeObservernameobject(delegate,"GKPlayerAuthenticationDidChangeNotificationName",null);
}
delegate = plus.ios.implements("NSObject",{"authenticationChanged:":authenticationChanged});
nc.addObserverselectornameobject(delegate,
plus.ios.newObject("@selector","authenticationChanged:"),
"GKPlayerAuthenticationDidChangeNotificationName",
null);
// 获取游戏玩家共享实例对象
var localplayer = GKLocalPlayer.localPlayer();
// 判断游戏玩家是否已经登录认证
if ( localplayer.plusGetAttribute("isAuthenticated") ) {
 // 玩家已登录认证，获取玩家信息
 playerInformation( localplayer );
 bLogin = true;
} else {
 // 玩家未登录认证，发起认证请求
 localplayer.authenticateWithCompletionHandler(null);
 eStart.innerText = "登录中...";
}
// 释放使用的对象
plus.ios.deleteObject(localplayer);
plus.ios.deleteObject(nc);
}, false );
</script>
</head>
<body>
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">plusSetAttribute</h1>
设置Objective-C示例对象的属性
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void insobj.plusSetAttribute( String name, Object value );
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>name: ( String ) 必选 要设置的属性名称 如果指定的属性名称不存在，则操作不生效，不会抛出异常。 </li><li>value: ( Object ) 必选 要设置的属性值 如果指定的属性值类型不区配，则操作不生效，不会抛出异常。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
<title>iOS Native.js</title>
<script type="text/javascript">
// 监听plusready事件
document.addEventListener( "plusready", function(){
// 扩展API加载完毕，现在可以正常调用扩展API
// 调用ios的文字转语音
var AVSpeechSynthesizer = plus.ios.importClass("AVSpeechSynthesizer");
var sppech = new AVSpeechSynthesizer();
var AVSpeechUtterance = plus.ios.importClass("AVSpeechUtterance");
var utterance =AVSpeechUtterance.speechUtteranceWithString("共产主义接班人");
// 设置语速
utterance.plusSetAttribute("rate",30.1);
sppech.speakUtterance(utterance);
}, false );
</script>
</head>
<body>
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
 </div>
 </div>
 <div id="treeSkill"></div>

页: [1]

宜信同城网交流论坛's Archiver

Native.js for iOS封装一条通过JS语法直接调用Native Objective-C接口通道，通过plus. ...