通用SDK

通用SDK用来帮助所有SDK做初始化和统一设置,比如设置语言、设置国家等。

初始化

初始化的操作请参见SDK初始化

设置国家相关

  1. 显示国家、地区列表页面

    • 调用默认页面

      IoTSmart.showCountryList(final ICountrySelectCallBack callBack);
    • 自定义UI页面

      IoTSmart.getCountryList(final ICountryListGetCallBack callback);
  2. 设置国家

    IoTSmart.setCountry(Country country, ICountrySetCallBack callBack);
    IoTSmart.setCountry(String domainAbbreviation, ICountrySetCallBack callBack);
    说明

    App在中国内地与除中国内地以外地区之间切换时,您需注意以下内容。

    • 使用API Level 9版本SDK时,不涉及切换安全图片,也不再需要重启App。

    • 使用API Level 8及以下版本SDK时,需要切换安全图片,并重启App后才能正确初始化。

设置多语言

生活物联网平台目前支持中文(zh-CN)、 英文(en-US)、法文(fr-FR)、德文(de-DE)、日文(ja-JP)、韩文(ko-KR)、西班牙文(es-ES)、俄文(ru-RU)、意大利文(it-IT)、印地文(hi-IN)、葡萄牙文(pt-PT)、波兰文(pl-PL)、荷兰文(nl-NL)、匈牙利语(hu-HU),共十四种语言。

  • 设置语言

    统一切换API网关、用户账号、推送、插件等SDK的语言环境。

    IoTSmart.setLanguage(String languagename);
  • 获取当前语言

    获取API网关、用户账号、推送、插件等SDK的语言环境。

    IoTSmart.getLanguage(String languageName);
    // 查看SDK当前设置的语言,如果您没有设置过语言,此处会返回当前系统语言

调试未发布产品

设置App配网列表的产品范围,取值如下。

  • PRODUCT_SCOPE_ALL:表示当前项目中已发布和未发布的所有产品。

  • PRODUCT_SCOPE_PUBLISHED:表示只包含已发布产品。正式发布的App请选择PRODUCT_SCOPE_PUBLISHED

IoTSmart.setProductScope(String productScope);

设置日志开关

设置日志开关的状态,取值如下。

  • true:表示显示所有日志

  • fasle:表示只显示error日志

IoTSmart.setDebug(boolean debug);

获取App当前连接的服务器ID

当自有App可以连接多个业务服务器时,为了App最佳的体验效果,可以根据当前登录服务器来选择业务服务器。此时,您可以通过以下接口获取App当前连接的国家(即登录服务器ID),从而帮助您选择其他业务服务器最快连接的区域。

IoTSmart.getShortRegionId()
说明
  • 该接口须升级至0.1.7.1及以上版本才可见。升级代码如下。

    com.aliyun.iot.aep.sdk:sdk-framework:0.1.7.1
  • 该接口必须要在App已登录状态下调用,否则没法获取准确的服务器ID。

平台返回服务器ID的值如下。

  • 0:华东2(上海)

  • 1:新加坡

  • 3:美国(弗吉尼亚)

  • 4:德国(法兰克福)

SDK API Reference

在使用生活物联网平台提供的SDK时,SDK API的相关注释请参见SDK API Reference