com.aispeech.dui.dds

## 类 DDS

- java.lang.Object
- - com.aispeech.dui.dds.DDS

-     public class DDS
      extends java.lang.Object

  Disclaim

  This program is the property of AI Speech Ltd. It shall be communicated to authorized personnel only. It is not to be disclosed outside the group without prior written consent. If you are not sure if you’re authorized to read this program, please contact info@aispeech.com before reading.

  Created by jinrui.gan on 17-3-12.

- - ### 字段概要

    字段
    限定符和类型 | 字段和说明
    --- | ---
    `static int` | `AUTH_COMPLETE_FULL`
    `static int` | `AUTH_COMPLETE_NONE`
    `static int` | `AUTH_COMPLETE_NOT_FULL`
    `static java.lang.String` | `BUS_SERVER_ADDR`
    `static java.lang.String` | `DNS_SERVER`
    `static int` | `ERROR_EXTRACT_DDS_BIN` Extract dds.bin error.
    `static int` | `ERROR_KERNEL_READY_TIMEOUT` Waiting sys.kernel.ready timeout error.
    `static int` | `ERROR_LASA_EXECUTE_FAILED` Lasa execute bootloader error.
    `static int` | `ERROR_NO_SPACE_LEFT`
    `static int` | `INIT_COMPLETE_FULL`
    `static int` | `INIT_COMPLETE_NONE`
    `static int` | `INIT_COMPLETE_NOT_FULL`

  - ### 方法概要

    所有方法 静态方法 实例方法 具体方法 已过时的方法
    限定符和类型 | 方法和说明
    --- | ---
    `void` | `doAuth()` 执行设备授权操作 异步返回，见 `DDSAuthListener`
    `Agent` | `getAgent()` 获取Agent
    `java.lang.String` | `getDeviceName()` 返回Profile授权方式下的deviceName信息
    `int` | `getInitStatus()` 获取当前初始化的状态
    `static DDS` | `getInstance()` 获取DDS实例
    `DDSUpdater` | `getUpdater()` 获取DDSUpdater
    `java.lang.String` | `getVersionName()` 获取DDS SDK的版本号
    `void` | `init(android.content.Context context, DDSConfig configs, DDSInitListener ddsInitListener, DDSAuthListener ddsAuthListener)` 初始化DDS SDK
    `boolean` | `isAuthSuccess()` 授权是否成功，该方法适用于api key授权
    `boolean` | `isInitComplete()` 已过时。
    `void` | `release()` 销毁DDS SDK
    `void` | `releaseSync()` 同步销毁 DDS SDK
    `boolean` | `setDebugMode(int level)` 设置日志模式,必须在`init(android.content.Context, com.aispeech.dui.dds.DDSConfig, com.aispeech.dui.dds.DDSInitListener, com.aispeech.dui.dds.DDSAuthListener)`之前调用才生效

    - ### 从类继承的方法 java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- - ### 字段详细资料

    - #### ERROR_EXTRACT_DDS_BIN

          public static final int ERROR_EXTRACT_DDS_BIN

      Extract dds.bin error.
      另请参阅:
        常量字段值

    - #### ERROR_LASA_EXECUTE_FAILED

          public static final int ERROR_LASA_EXECUTE_FAILED

      Lasa execute bootloader error. Contact us.
      另请参阅:
        常量字段值

    - #### ERROR_KERNEL_READY_TIMEOUT

          public static final int ERROR_KERNEL_READY_TIMEOUT

      Waiting sys.kernel.ready timeout error. Contact us.
      另请参阅:
        常量字段值

    - #### ERROR_NO_SPACE_LEFT

          public static final int ERROR_NO_SPACE_LEFT

      另请参阅:
        常量字段值

    - #### INIT_COMPLETE_NONE

          public static final int INIT_COMPLETE_NONE

      另请参阅:
        常量字段值

    - #### INIT_COMPLETE_NOT_FULL

          public static final int INIT_COMPLETE_NOT_FULL

      另请参阅:
        常量字段值

    - #### INIT_COMPLETE_FULL

          public static final int INIT_COMPLETE_FULL

      另请参阅:
        常量字段值

    - #### AUTH_COMPLETE_NONE

          public static final int AUTH_COMPLETE_NONE

      另请参阅:
        常量字段值

    - #### AUTH_COMPLETE_NOT_FULL

          public static final int AUTH_COMPLETE_NOT_FULL

      另请参阅:
        常量字段值

    - #### AUTH_COMPLETE_FULL

          public static final int AUTH_COMPLETE_FULL

      另请参阅:
        常量字段值

    - #### DNS_SERVER

          public static final java.lang.String DNS_SERVER

      另请参阅:
        常量字段值

    - #### BUS_SERVER_ADDR

          public static java.lang.String BUS_SERVER_ADDR

  - ### 方法详细资料

    - #### getInstance

          public static DDS getInstance()

      获取DDS实例
      返回:
        DDS DDS实例

    - #### getVersionName

          public java.lang.String getVersionName()

      获取DDS SDK的版本号
      返回:
        String 版本号

    - #### init

          public void init(android.content.Context context,
                           DDSConfig configs,
                           DDSInitListener ddsInitListener,
                           DDSAuthListener ddsAuthListener)

      初始化DDS SDK
      参数:
        `context` - Android context.
        `configs` - 初始化的配置
        `ddsInitListener` - 初始化回调方法
        `ddsAuthListener` - 授权回调方法

    - #### release

          public void release()

      销毁DDS SDK

    - #### releaseSync

          public void releaseSync()

      同步销毁 DDS SDK

    - #### getAgent

          public Agent getAgent()

      获取Agent
      返回:
        Agent agent实例

    - #### getUpdater

          public DDSUpdater getUpdater()
                                throws DDSNotInitCompleteException

      获取DDSUpdater
      返回:
        DDSUpdater DDSUpdater实例
      抛出:
        `DDSNotInitCompleteException` - 如果DDS没有初始化完成，会抛出exception

    - #### doAuth

          public void doAuth()
                      throws DDSNotInitCompleteException

      执行设备授权操作 异步返回，见 `DDSAuthListener`
      抛出:
        `DDSNotInitCompleteException`

    - #### getDeviceName

          public java.lang.String getDeviceName()
                                         throws DDSNotInitCompleteException

      返回Profile授权方式下的deviceName信息
      返回:
        deviceName 未授权则该值为空字符串""
      抛出:
        `DDSNotInitCompleteException`

    - #### isAuthSuccess

          public boolean isAuthSuccess()
                                throws DDSNotInitCompleteException

      授权是否成功，该方法适用于api key授权
      返回:
        boolean true：成功 false:没有成功
      抛出:
        `DDSNotInitCompleteException`

    - #### isInitComplete

          @Deprecated
          public boolean isInitComplete()

      已过时。
      初始化是否成功
      返回:
        boolean true：成功 false:没有成功 此方法已弃用，参见`DDS#getInstance()#getInitStatus()`

    - #### getInitStatus

          public int getInitStatus()

      获取当前初始化的状态
      返回:
        DDS.INIT_COMPLETE_NONE 还未初始化完成，表示DDS正在初始化 DDS.INIT_COMPLETE_NOT_FULL 部分初始化完成，表示DDS已经初始化完成，但还没有完成更新 DDS.INIT_COMPLETE_FULL 完全初始化完成，已经完成更新

    - #### setDebugMode

          public boolean setDebugMode(int level)

      设置日志模式,必须在`init(android.content.Context, com.aispeech.dui.dds.DDSConfig, com.aispeech.dui.dds.DDSInitListener, com.aispeech.dui.dds.DDSAuthListener)`之前调用才生效
      参数:
        `level` - 可选值1,2,3,4,5 默认值：4