openApp

打開(kāi)手機(jī)上其它應(yīng)用，可以傳遞參數(shù)

openApp({params}, callback(ret, err))

params

appParam：

• 類(lèi)型：JSON 對(duì)象
• 默認(rèn)值：無(wú)
• 描述：（可選項(xiàng)）傳給目標(biāo)應(yīng)用的參數(shù)。iOS 平臺(tái)會(huì)將 appParam 里面的值拼接到 iosUrl 后面，比如 iosUrl 為 http://www.baidu.com ，appParam為{"keyword":"APICloud"}，則最后傳遞給第三方應(yīng)用的url為http://www.baidu.com?keyword=APICloud

iosUrl：

• 類(lèi)型：字符串
• 默認(rèn)值：無(wú)
• 描述：（可選項(xiàng)）目標(biāo)應(yīng)用的url（iOS平臺(tái)使用），iOS下必傳

androidPkg：

• 類(lèi)型：字符串
• 默認(rèn)值：無(wú)
• 描述：（可選項(xiàng)）目標(biāo)應(yīng)用的包名或 action（Android平臺(tái)使用），Android下必傳

mimeType：

• 類(lèi)型：字符串
• 默認(rèn)值：無(wú)
• 描述：（可選項(xiàng)）指定目標(biāo)應(yīng)用的響應(yīng)數(shù)據(jù)類(lèi)型，如："text/html"（Android平臺(tái)使用）

uri：

• 類(lèi)型：字符串
• 默認(rèn)值：無(wú)
• 描述：（可選項(xiàng)）指定目標(biāo)應(yīng)用響應(yīng)的uri（Android平臺(tái)使用）

callback(ret, err)

ret：

• 類(lèi)型：JSON 對(duì)象
• 描述：目標(biāo)應(yīng)用關(guān)閉后的返回值，只支持Android

err：

• 類(lèi)型：JSON 對(duì)象
• 內(nèi)部字段：

{
    msg:""      //錯(cuò)誤描述
}

示例代碼

//iOS中的使用方法如下：


api.openApp({
    iosUrl: 'weixin://',     //打開(kāi)微信，其中weixin為微信的URL Scheme
    appParam: {
        appParam: 'app參數(shù)'
    }
});


api.openApp({
    iosUrl: 'app-settings:'  //打開(kāi)應(yīng)用設(shè)置界面，支持iOS 8及以上系統(tǒng)
});


//Android中的使用方法如下：


api.openApp({
    androidPkg: 'android.intent.action.VIEW',
    mimeType: 'text/html',
    uri: 'http://www.baidu.com'
}, function(ret, err) {
    if (ret) {
        api.alert({
            msg:JSON.stringify(ret)
        });
    } else {
        api.alert({
            msg:JSON.stringify(err)
        });
    }
});

可用性

iOS系統(tǒng)，Android系統(tǒng)

可提供的1.0.0及更高版本