ios

Native.js for iOS封装一条通过JS语法直接调用Native Objective-C接口通道，通过plus.ios可调用几乎所有的系统API。

方法：

对象：

权限：

5+功能模块（permissions）

  2. {
  3. // ...
  4. "permissions":{
  5.     // ...
  6.     "Invocation": {
  7.         "description": "Native.js"
  8.     }
  9. }
  10. }
  11.

importClass

导入Objective-C类对象

  2. ClassObject plus.ios.importClass( String classname );
  3.

说明：

导入类对象后，就可以通过.操作符直接调用对象（类对象/实例对象）的方法。通过.操作符号调用方法时，不需要使用":"来分割参数。注意：导入类对象将会消耗较多的系统资源，不应该导入过多的类对象，可以使用plus.ios.invoke()来调用未导入类实例对象的方法。

参数：

  • classname: (String|InstanceObject)必选 要导入的Objective-C类名如果指定的类名不存在，则导入类失败，不会抛出异常。

返回值：

ClassObject: Objective-C类对象，如果导入类对象失败则返回null。

示例：

  2. <!DOCTYPE html>
  3. <html>
  4.     <head>
  5.     <meta charset="utf-8"/>
  6.     <meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
  7.     <title>iOS Native.js</title>
  8.     <script type="text/javascript">
  9. // 监听plusready事件  
  10. document.addEventListener( "plusready", function(){
  11.     // 扩展API加载完毕，现在可以正常调用扩展API
  12.     // 导入GKLocalPlayer
  13.     var GKLocalPlayer  = plus.ios.importClass("GKLocalPlayer");
  14. }, false );
  15.     </script>
  16.     </head>
  17.     <body>
  18.     </body>
  19. </html>
  20.

uni-app使用plus注意事项

newObject

创建实例对象

  2. InstanceObject plus.ios.newObject( String classname, Object..args );
  3.

参数：

  • classname: (String)必选 要创建实例对象的类名如果指定的类名不存在，则创建对象失败，不会抛出异常。
  • args: (Object)可选 创建实例对象的构造参数如果指定的构造参数类型不区配，则创建对象失败，不会抛出异常。

返回值：

InstanceObject: Objective-C实例对象，如果创建对象失败则返回null。

示例：

  2. <!DOCTYPE html>
  3. <html>
  4.     <head>
  5.     <meta charset="utf-8"/>
  6.     <meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
  7.     <title>iOS Native.js</title>
  8.     <script type="text/javascript">
  9. // 监听plusready事件  
  10. document.addEventListener( "plusready", function(){
  11.     // 扩展API加载完毕，现在可以正常调用扩展API
  12.     // 创建GKLocalPlayer类的一个实例对象
  13.     var localplayer  = plus.ios.newObject("GKLocalPlayer");
  14. }, false );
  15.     </script>
  16.     </head>
  17.     <body>
  18.     </body>
  19. </html>
  20.

uni-app使用plus注意事项

deleteObject

销毁实例对象

  2. void plus.ios.deleteObject( Object obj );
  3.

参数：

  • obj: (Object)必选 要销毁的实例对象如果obj对象不是有效的实例对象，则不执行销毁对象操作，不会抛出异常。如果不执行销毁实例对象操作，在页面关闭时会自动执行销毁对象的操作。

返回值：

void: 无

示例：

  2. <!DOCTYPE html>
  3. <html>
  4.     <head>
  5.     <meta charset="utf-8"/>
  6.     <meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
  7.     <title>iOS Native.js</title>
  8.     <script type="text/javascript">
  9. // 监听plusready事件  
  10. document.addEventListener( "plusready", function(){
  11.     // 扩展API加载完毕，现在可以正常调用扩展API
  12.     // 创建GKLocalPlayer类的一个实例对象
  13.     var localplayer  = plus.ios.newObject("GKLocalPlayer");
  14.     // ...
  15.     // 销毁GKLocalPlayer示例对象
  16.     plus.ios.deleteObject( localplayer );
  17. }, false );
  18.     </script>
  19.     </head>
  20.     <body>
  21.     </body>
  22. </html>
  23.

uni-app使用plus注意事项

invoke

调用对象（类对象/示例对象）的方法

  2. Object plus.ios.invoke( Object obj, String name, Object... args );
  3.

参数：

  • obj: (InstanceObject|ClassObject|String)必选 调用方法所属的对象，也可以是类的名称如果obj为实例对象（InstanceObject）类型，则调用的是实例对象的方法；如果obj为类对象（ClassObject）类型，则调用的是类的静态方法；如果obj为字符串（String）类型，其值必须是类的名称，则调用的是类的静态方法；
  • name: (String)必选 要调用的方法名称方法名称中使用":"分隔参数。如果指定的方法名称不存在，则调用方法失败，不会抛出异常。
  • args: (Object)可选 调用方法的参数如果指定的参数数目或类型不区配，则调用方法失败，不会抛出异常。

返回值：

Object: 调用方法的返回值，如果调用方法失败，则返回null。

示例：

  2. <!DOCTYPE html>
  3. <html>
  4.     <head>
  5.     <meta charset="utf-8"/>
  6.     <meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
  7.     <title>iOS Native.js</title>
  8.     <script type="text/javascript">
  9. // 监听plusready事件  
  10. document.addEventListener( "plusready", function(){
  11.     // 扩展API加载完毕，现在可以正常调用扩展API
  12. 　　// 创建UIAlertView类的实例对象
  13. 　　var view = plus.ios.newObject("UIAlertView");
  14. 　　// 设置提示对话上的内容，这里的方法名称中必须包含':'字符
  15. 　　plus.ios.invoke(view,"initWithTitle:message:delegate:cancelButtonTitle:otherButtonTitles:"
  16. 　　    , "自定义标题" // 提示框标题
  17. 　　    , "使用NJS的原生弹出框，可自定义弹出框的标题、按钮"  // 提示框上显示的内容
  18. 　　    , null // 操作提示框后的通知代理对象，暂不设置
  19. 　　    , "确定(或者其他字符)" // 提示框上取消按钮的文字
  20. 　　    , null ); // 提示框上其它按钮的文字，设置为null表示不显示
  21. 　　// 调用show方法显示提示对话框，在JS中使用()语法调用对象的方法
  22. 　　plus.ios.invoke(view,"show");
  23. }, false );
  24.     </script>
  25.     </head>
  26.     <body>
  27.     </body>
  28. </html>
  29.

uni-app使用plus注意事项

implements

实现代理的方法

  2. InstanceObject plus.ios.implements( String name, Object obj );
  3.

参数：

  • name: (String)必选 代理的名称，也可以是自定的字符串名称如果name为自定的字符串名称，则自定义一个代理；
  • obj: _(Object)必选 _JSON对象类型，代理实现方法的定义JSON对象中key值为代理方法的名称，使用":"分割参数；value值为Function，方法参数必须与代理方法中的":"区配。

返回值：

InstanceObject: 代理实例对象。

示例：

  2. <!DOCTYPE html>
  3. <html>
  4.     <head>
  5.     <meta charset="utf-8"/>
  6.     <meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
  7.     <title>iOS Native.js</title>
  8.     <script type="text/javascript">
  9. // 监听plusready事件  
  10. document.addEventListener( "plusready", function(){
  11.     // 扩展API加载完毕，现在可以正常调用扩展API
  12.     // 登录到游戏中心
  13.     // 监听用户登录状态变更事件
  14.     var nc = NSNotificationCenter.defaultCenter();
  15.     if(delegate){
  16.         nc.removeObservernameobject(delegate,"GKPlayerAuthenticationDidChangeNotificationName",null);
  17.     }
  18.     delegate = plus.ios.implements("NSObject",{"authenticationChanged:":authenticationChanged});
  19.     nc.addObserverselectornameobject(delegate,
  20.         plus.ios.newObject("@selector","authenticationChanged:"),
  21.         "GKPlayerAuthenticationDidChangeNotificationName",
  22.         null);
  23.     // 获取游戏玩家共享实例对象
  24.     var localplayer = GKLocalPlayer.localPlayer();
  25.     // 判断游戏玩家是否已经登录认证
  26.     if ( localplayer.plusGetAttribute("isAuthenticated") ) {
  27.         // 玩家已登录认证，获取玩家信息
  28.         playerInformation( localplayer );
  29.         bLogin = true;
  30.     } else {
  31.         // 玩家未登录认证，发起认证请求
  32.         localplayer.authenticateWithCompletionHandler(null);
  33.         eStart.innerText = "登录中...";
  34.     }
  35.     // 释放使用的对象
  36.     plus.ios.deleteObject(localplayer);
  37.     plus.ios.deleteObject(nc);
  38. }, false );
  39.     </script>
  40.     </head>
  41.     <body>
  42.     </body>
  43. </html>
  44.

uni-app使用plus注意事项

currentWebview

获取当前Webview窗口对象的native层UIWebview实例对象

  2. InstanceObject plus.ios.currentWebview();
  3.

说明：

UIWebview对象的API请参考Apple开发文档UIWebview

参数：

无

返回值：

InstanceObject: Webview窗口对象的native层实例对象，如果调用方法失败，则返回null。

示例：

  2. <!DOCTYPE html>
  3. <html>
  4.     <head>
  5.     <meta charset="utf-8"/>
  6.     <meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
  7.     <title>iOS Native.js</title>
  8.     <script type="text/javascript">
  9. var nwv=null;
  10. // 监听plusready事件  
  11. document.addEventListener( "plusready", function(){
  12.     // 扩展API加载完毕，现在可以正常调用扩展API
  13.     // 获取当前Webview窗口的UIWebview实例对象
  14.     nwv = plus.ios.currentWebview();
  15.     // ...
  16. }, false );
  17. // 使用Native.js调用Webview的loadUrl方法跳转页面
  18. function loadUrl(){
  19.     // 导入UIWebview、NSURLRequest、NSURL类
  20.     var Webview = plus.ios.importClass("UIWebview");
  21.     var NSURLRequest = plus.ios.import('NSURLRequest');
  22.     var NSURL = plus.ios.import('NSURL');
  23.     // 获取当前Webview对象的实例
  24.     var wv = plus.ios.currentWebview();
  25.     // 创建请求对象
  26.     var req = NSURLRequest.requestWithURL(NSURL.URLWithString('http://www.dcloud.io/'));
  27.     // 跳转页面
  28.     plus.ios.invoke(wv,"loadRequest:",req);
  29.     // 释放对象(可选)
  30.     plus.ios.deleteObject(req);
  31.     plus.ios.deleteObject(wv);
  32. }
  33.     </script>
  34.     </head>
  35.     <body>
  36.         获取当前Webview窗口对象的native层UIWebview实例对象<br/>
  37.         <button onclick="loadUrl()">Native.js跳转页面</button>
  38.     </body>
  39. </html>
  40.

uni-app使用plus注意事项

ClassObject

Objective-C类对象

  2. interface ClassObject {
  3.     // ...
  4. }
  5.

说明：

Objective-C类对象，可通过其属性获取类的常量，可通过方法来操作类的静态方法，也通过new方法来创建类的实例对象。对于类的静态方法，则直接通过.后面跟随方法名称调用。

示例：

  2. <!DOCTYPE html>
  3. <html>
  4.     <head>
  5.     <meta charset="utf-8"/>
  6.     <meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
  7.     <title>iOS Native.js</title>
  8.     <script type="text/javascript">
  9. // 监听plusready事件  
  10. document.addEventListener( "plusready", function(){
  11.     // 扩展API加载完毕，现在可以正常调用扩展API
  12.     // 调用ios的文字转语音
  13.     var AVSpeechSynthesizer = plus.ios.importClass("AVSpeechSynthesizer");
  14.     var sppech = new AVSpeechSynthesizer(); // 实例化AVSpeechSynthesizer类对象
  15.     // ...
  16. }, false );
  17.     </script>
  18.     </head>
  19.     <body>
  20.     </body>
  21. </html>
  22.

uni-app使用plus注意事项

InstanceObject

Objective-C实例对象

  2. interface InstanceObject {
  3.     // ...
  4.     function Object plusGetAttribute( String name );
  5.     function Object plusSetAttribute( String name, Object value );
  6.     // ...
  7. }
  8.

说明：

Objective-C实例对象，可通过其方法来操作示例的变量和方法。注意：必须通过plusGetAttribute()方法读取示例对象的属性值，通过plusSetAttribute()方法设置示例对象的属性值。

方法：

plusGetAttribute

获取Objective-C实例对象的属性


Object insobj.plusGetAttribute( String name );

参数：

  • name: (String)必选 实例属性的名称如果指定的属性名称不存在，则返回null。

返回值：

Object: 属性的实例对象

示例：


<!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>

uni-app使用plus注意事项

plusSetAttribute

设置Objective-C示例对象的属性


void insobj.plusSetAttribute( String name, Object value );

参数：

  • name: (String)必选 要设置的属性名称如果指定的属性名称不存在，则操作不生效，不会抛出异常。
  • value: (Object)必选 要设置的属性值如果指定的属性值类型不区配，则操作不生效，不会抛出异常。

返回值：

void: 无

示例：


<!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>

uni-app使用plus注意事项