Android客户端接入

1.概述

2.准备工作

• 请确保您的终端设备已经开启了网络。
• 请确保已经在阿里云控制台开通了号码认证服务并创建了对应的短信验证码方案，以及短信签名、模版均已绑定该方案。
• 您也可以登录阿里云官网查看接入流程，单击查看完整使用流程。

3.搭建开发环境

添加依赖

AAR方式。

下载SDK并解压后，将所有aar文件拷贝至工程的libs目录下。

<uses-permission android:name="android.permission.INTERNET" />   <!-- 网络访问 -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <!-- 检查网络状态 -->

4.SDK方法说明

• 获取实例。

  SmsAuthHelper smsAuthHelper = new SmsAuthHelper(context, sceneCode);

• 设置Token更新处理器（TokenUpdater）。

  /**
   * 设置token更新器
   *
   * @param tokenUpdater
   */
  public void setTokenUpdater(TokenUpdater tokenUpdater);

• 发送短信验证码。

  /**
   * 发送短信验证码
   * @param countryCode 国际电话区号，目前仅作为保留字段，当前版本只支持86（即中国大陆的电话号码）
   * @param phoneNumber 手机号
   * @param callback
   * @param timeoutMills 接口超时时间（单位：ms）
   */
  public void sendVerifyCode(int countryCode,
                                 String phoneNumber,
                                 SmsCallback callback, long timeoutMills) 

• 销毁实例。

  /**
   * 销毁实例
   */
  public void destroy();

5.SDK回调说明

TokenUpdater

public interface TokenUpdater {
    /**
     * 更新Token1
     * @return
     */
    Tokens updateToken();
}

SDK在检测到本地缓存中无有效Token时（Token不存在或者已过期）则会调用TokenUpdater#updateToken方法，开发者需要实现该接口，并且获取到Token后，封装成Tokens返回给SDK。Tokens中的具体有哪些字段可参考Demo和接口文档。

SmsCallback

调用发送验证码接口时，发送结果将通过该接口通知给开发者，无论成功或者失败，开发者均可以根据返回的Ret对象中的code字段去判断。

public interface SmsCallback {
    void onResult(Ret ret);
}

6.SDK事件返回码

进行错误码处理的时候推荐直接使用ResultCode中的常量来处理，不建议直接使用值。