通用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)等十三种语言。

  • 设置语言

    统一切换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:上海
  • 1:新加坡
  • 3:美国
  • 4:德国

SDK API Reference

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