moblinkpro

getMobId restoreScene

概述

移动端场景还原解决方案。10分钟快速集成MobLink,场景还原解决方案即可打破App孤岛,实现Web与App的无缝链接,让App间无缝跳转,加强用户体验,提升App活跃度。

配置集成

iOS平台设置参考iOS集成文档 参考其中的第一点:进行官网后台配置

如有问题请联系技术支持:

  1. 服务电话: 400-685-2216
  2. QQ: 4006852216
  3. 节假日值班电话:
  4. iOS185-1664-1951
  5. Android: 185-1664-1950
  6. 电子邮箱: support@mob.com
  7. 市场合作: 021-54623100

模块使用攻略

ios 需要将plist 文件放入res目录下,文件内容:

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
  3. <plist version="1.0">
  4. <dict>
  5. <key>MOBAppKey</key>
  6. <string>moba6b6c6d6</string>
  7. <key>MOBAppSecret</key>
  8. <string>b89d2427a3bc7ad1aea1e1e8c1d36bf3</string>
  9. <key>CFBundleURLTypes</key>
  10. <array>
  11. <dict>
  12. <key>CFBundleTypeRole</key>
  13. <string>Editor</string>
  14. <key>CFBundleURLSchemes</key>
  15. <array>
  16. <string>在Mob官网后台配置的URL Scheme</string>
  17. </array>
  18. </dict>
  19. </array>
  20. </dict>
  21. </plist>

Android 只需要配置config.xml,添加一下内容:

  1. <feature name="mobSDK">
  2. <param name="Mob-AppKey" value="你的AppKey"/>
  3. <param name="Mob-AppSecret" value="你的AppSecret"/>
  4. </feature>
  • 字段描述:

Mob-AppKey:(必须配置)从Mob官网获取的 AppKey。AppKey 申请方法参考快速集成获取apppkey和appSecret。

Mob-AppSecret:(必须配置)从Mob官网获取的 AppSecret。AppSecret 申请方法参考快速集成获取apppkey和appSecret。

  • Android模块接入特别注意:

由于apicloud只能配置urlshceme 到 entrancActivity,这导致部分场景下无法进行还原,所以请在mob官网moblink 配置andriod的scheme为 mlink。

widget\res\UZApp.entitlements的配置

该文件是给iOS平台配置的文件,在widget\res下创建文件名为UZApp.entitlements的文件,UZApp.entitlements内容如下:

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
  3. <plist version="1.0">
  4. <dict>
  5. <key>com.apple.developer.associated-domains</key>
  6. <array>
  7. <!--这里换成你在mob后台获取到的iOS的“Universal Link”值-->
  8. <string>applinks:z.t4m.cn</string>
  9. </array>
  10. </dict>
  11. </plist>

模块接口

getMobId

获取mobid

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

params

path:

  • 类型:json字符串(只能包含path和params,请参考示例代码)
  • 描述:在Mob后台配置的需要还原的控制器对应的路径。

params:

  • 类型:json字符串
  • 描述:此时传入的字典数据,在场景还原时能够重新得到。

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. mobid : 'b2E7Jr'//此处是示例id
  3. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. error : {'code' : code, 'userInfo' : error.userInfo}
  3. }

示例代码

  1. var moblink = api.require('moblinkpro');
  2. moblink.getMobId({
  3. path:"/demo/a",
  4. params:{"key1":"value1","key2":"value2"}
  5. },function(ret, err){
  6. var msg = ret.mobid; // applink(universal link)拼接mobid为可以跳转回应用的短链,如applink为applinks:z.t4m.cn,则短链为https://z.t4m.cn/b2E7Jr,也可以拼接mobid到自己的网址
  7. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

restoreScene

获取场景数据 请在apiready() 函数中进行调用

restoreScene(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. path : '/demo/a',
  3. params : {"key1":"value1","key2":"value2"}
  4. }

示例代码

  1. var moblink = api.require('moblinkpro');
  2. moblink.restoreScene(function(ret){
  3. var msg = "path:" + ret.path + "\nparams:" + JSON.stringify(ret.params);
  4. // ret.path为场景信息中携带的路径
  5. // ret.params为场景信息中携带的参数
  6. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本