# [ios]()
Native.js for iOS封装一条通过JS语法直接调用Native Objective-C接口通道，通过plus.ios可调用几乎所有的系统API。
### 方法：
- [importClass](http://www.dcloud.io/docs/api/zh_cn/ios.shtml#plus.ios.importClass): 导入Objective-C类对象
- [newObject](http://www.dcloud.io/docs/api/zh_cn/ios.shtml#plus.ios.newObject): 创建实例对象
- [deleteObject](http://www.dcloud.io/docs/api/zh_cn/ios.shtml#plus.ios.deleteObject): 销毁实例对象
- [invoke](http://www.dcloud.io/docs/api/zh_cn/ios.shtml#plus.ios.invoke): 调用对象（类对象/示例对象）的方法
- [implements](http://www.dcloud.io/docs/api/zh_cn/ios.shtml#plus.ios.implements): 实现代理的方法
- [currentWebview](http://www.dcloud.io/docs/api/zh_cn/ios.shtml#plus.ios.currentWebview): 获取当前Webview窗口对象的native层UIWebview实例对象
### 对象：
- [ClassObject](http://www.dcloud.io/docs/api/zh_cn/ios.shtml#plus.ios.ClassObject): Objective-C类对象
- [InstanceObject](http://www.dcloud.io/docs/api/zh_cn/ios.shtml#plus.ios.InstanceObject): Objective-C实例对象
### 权限：
permissions
~~~
"Invocation": {
"description": "Javascript桥"
}
~~~
# [importClass]()
导入Objective-C类对象
~~~
ClassObject plus.ios.importClass( String classname );
~~~
### 说明：
导入类对象后，就可以通过.操作符直接调用对象（类对象/实例对象）的常量和方法。 通过.操作符号调用方法时，不需要使用":"来分割参数。 注意：导入类对象将会消耗较多的系统资源，不应该导入过多的类对象，可以使用plus.ios.invoke()来调用未导入类实例对象的方法。
### 参数：
- classname: *( String ) 必选 *要导入的Objective-C类名
如果指定的类名不存在，则导入类失败，不会抛出异常。
### 返回值：
ClassObject : Objective-C类对象，如果导入类对象失败则返回null。
### 示例：
~~~
<!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>
~~~
# [newObject]()
创建实例对象
~~~
InstanceObject plus.ios.newObject( String classname, Object..args );
~~~
### 参数：
- classname: *( String ) 必选 *要创建实例对象的类名
如果指定的类名不存在，则创建对象失败，不会抛出异常。
- args: *( Object ) 可选 *创建实例对象的构造参数
如果指定的构造参数类型不区配，则创建对象失败，不会抛出异常。
### 返回值：
InstanceObject : Objective-C实例对象，如果创建对象失败则返回null。
### 示例：
~~~
<!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>
~~~
# [deleteObject]()
销毁实例对象
~~~
void plus.ios.deleteObject( Object obj );
~~~
### 参数：
- obj: *( Object ) 必选 *要销毁的实例对象
如果obj对象不是有效的实例对象，则不执行销毁对象操作，不会抛出异常。 如果不执行销毁实例对象操作，在页面关闭时会自动执行销毁对象的操作。
### 返回值：
void : 无
### 示例：
~~~
~~~
# [invoke]()
调用对象（类对象/示例对象）的方法
~~~
Object plus.ios.invoke( Object obj, String name, Object... args );
~~~
### 参数：
- obj: *( Object ) 必选 *调用方法所属的对象，也可以是类的名称
如果obj为类对象，则调用的是类的静态方法；如果obj为实例对象，则调用的是实例的方法； 如果obj为字符串类型，其值必须是类的名称，则调用的是类的静态方法；
- name: *( String ) 必选 *要调用的方法名称
方法名称中使用":"分隔参数。 如果指定的方法名称不存在，则调用方法失败，不会抛出异常。
- args: *( Object ) 可选 *调用方法的参数
如果指定的参数数目或类型不区配，则调用方法失败，不会抛出异常。
### 返回值：
Object : 调用方法的返回值，如果调用方法失败，则返回null。
### 示例：
~~~
<!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>
~~~
# [implements]()
实现代理的方法
~~~
Object plus.ios.implements( String name, Object obj );
~~~
### 参数：
- name: *( String ) 必选 *代理的名称，也可以是自定的字符串名称
如果name为自定的字符串名称，则自定义一个代理；
- obj: *( Object ) 必选 *JSON对象类型，代理实现方法的定义
JSON对象中key值为代理方法的名称，使用":"分割参数；value值为Function，方法参数必须与代理方法中的":"区配。
### 返回值：
InstanceObject : 代理实例对象。
### 示例：
~~~
<!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
// ...
}, false );
</script>
</head>
<body>
</body>
</html>
~~~
# [currentWebview]()
获取当前Webview窗口对象的native层UIWebview实例对象
~~~
InstanceObject plus.ios.currentWebview();
~~~
### 参数：
无
### 返回值：
[InstanceObject](http://www.dcloud.io/docs/api/zh_cn/ios.shtml#plus.ios.InstanceObject) : Webview窗口对象的native层实例对象，如果调用方法失败，则返回null。
### 示例：
~~~
<!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
// ...
}, false );
</script>
</head>
<body>
</body>
</html>
~~~
# [ClassObject]()
Objective-C类对象
~~~
interface ClassObject {
// ...
function Object plusGetAttribute( String name );
function Object plusSetAttribute( String name, Object value );
// ...
}
~~~
### 说明：
Objective-C类对象，可通过其属性获取类的常量，可通过方法来操作类的静态变量和方法，也通过new方法来创建类的实例对象。 对于类的常量，则直接通过.后面跟随常量名称调用即可。
### 方法：
- [plusGetAttribute](http://www.dcloud.io/docs/api/zh_cn/ios.shtml#plus.ios.ClassObject.plusGetAttribute): 获取Objective-C类对象的静态属性
- [plusSetAttribute](http://www.dcloud.io/docs/api/zh_cn/ios.shtml#plus.ios.ClassObject.plusSetAttribute): 设置Objective-C类对象的静态属性
# [plusGetAttribute]()
获取Objective-C类对象的静态属性
~~~
Object clsobj.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
// ...
}, false );
</script>
</head>
<body>
</body>
</html>
~~~
# [plusSetAttribute]()
设置Objective-C类对象的静态属性
~~~
void clsobj.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
// ...
}, false );
</script>
</head>
<body>
</body>
</html>
~~~
# [InstanceObject]()
Objective-C实例对象
~~~
interface InstanceObject {
// ...
function Object plusGetAttribute( String name );
function Object plusSetAttribute( String name, Object value );
// ...
}
~~~
### 说明：
Objective-C实例对象，可通过其方法来操作示例的变量和方法。 注意：必须通过plusGetAttribute()方法读取示例对象的属性值，通过plusSetAttribute()方法设置示例对象的属性值。
### 方法：
- [plusGetAttribute](http://www.dcloud.io/docs/api/zh_cn/ios.shtml#plus.ios.InstanceObject.plusGetAttribute): 获取Objective-C实例对象的属性
- [plusSetAttribute](http://www.dcloud.io/docs/api/zh_cn/ios.shtml#plus.ios.InstanceObject.plusSetAttribute): 设置Objective-C示例对象的属性
# [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
// ...
}, false );
</script>
</head>
<body>
</body>
</html>
~~~
# [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
// ...
}, false );
</script>
</head>
<body>
</body>
</html>
~~~
- API参考
- Accelerometer
- Audio
- Camera
- Contacts
- Device
- Downloader
- Events
- Gallery
- Geolocation
- IO
- Key
- Messaging
- NativeUI
- Navigator
- Orientation
- Proximity
- SplashScreen
- Storage
- UI
- Uploader
- InterfaceOrientation
- Runtime
- WebView
- XMLHttpRequest
- Zip
- Plugins
- Barcode
- Maps
- Payment
- Push
- Share
- Speech
- Statistic
- Native.js
- Android
- iOS