• 1.网络身份证功能开发包说明
• 2.二次开发说明
  • 2.1 AndroidStudio工程配置说明
  • 2.2 AndroidManifest.xml配置说明
  • 2.3 接口说明
  • 2.4 接口调用流程
  • 2.5 错误码说明
  • 2.6 接口调用案例
• 3.二次开发问题汇总

• 注册方式：
  • 试用注册
  • 购买正式授权码注册

• 在Project视图下，在moudle/libs/下添加aar开发包

• 配置moudle build文件

android {
    defaultConfig {
        ....
        //必须1
        targetSdkVersion 22
    }
}



//必须2
repositories {
    flatDir {
        dirs 'libs'   // aar目录
    }
}

dependencies {
    ....
    ////必须3
    implementation(name: 'net_idcard_sdk_20190522', ext: 'aar')

}

    <uses-permission android:name="android.permission.NFC" />
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

RegisterAPI 类

• public void testRegisterDeive(Context context)

  申请测试授权
  context:上下文
  
  

• public void registerDevice(Context context, String registerCode)

    申请正式授权
    context:上下文
    registerCode:商务给的正式授权码，联系商务购买
  

ReadAPI 类

• public ReadAPI(Context context, int base, int license, String path, ReadListener readListener, Conn conn)

  构造函数
  context:上下文
  base:  R.raw.base
  license: R.raw.license
  path: 身份证头像图片存储路径
  readListener: 读卡状态结果监听回调
  conn: 接口
  
  

• public void read(Intent intent)

  NFC读卡方法
  intent:NFC识别到的tag
  

• public void read()

  USB读卡方法，需要CR30S设备
  

• 网络身份证设备注册

  private RegisterAPI api;
  
  
  @Override
  protected void onCreate(@Nullable Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      api = new RegisterAPI(this);
  }
  
  public void bt_register(View view) {
          if (!isNetworkAvailable()) {
              Toast.makeText(this, "授权需要联网!", Toast.LENGTH_SHORT).show();
              return;
          }
          api.registerDevice(MainActivity.this, mEtRegistrationCode.getText().toString());
   }
  
   public void bt_try_register(View view) {
          if (!isNetworkAvailable()) {
              Toast.makeText(this, "授权需要联网!", Toast.LENGTH_SHORT).show();
              return;
          }
          api.testRegisterDeive(MainActivity.this);
   }
  
  @Override
  public void error(int errorCode) {
  
  }
  
  @Override
  public void registerSuccess() {
      Toast.makeText(getApplicationContext(), "激活成功！", Toast.LENGTH_SHORT).show();
  }

• NFC读网络身份证

  以下只是最主要的处理流程，具体的还请参考源代码

  <activity
      android:name=".NFCTestActivity"
      android:launchMode="singleTop">
      <intent-filter>
          <action android:name="android.nfc.action.TECH_DISCOVERED" />
      </intent-filter>
  </activity>
  

  public class DemoActivity extends BaseActivity implements ReadListener{
      private NfcAdapter mNfcAdapter;
      private PendingIntent mPendingIntent;
      private IntentFilter[] mIntentFilters;
      private String[][] mTechLists;
      public ReadAPI api;
      private long startMillis;
      @Override
      protected void onCreate(Bundle savedInstanceState) {
          super.onCreate(savedInstanceState);
          setContentView(R.layout.activity_idcard);
          ...
          mNfcAdapter = NfcAdapter.getDefaultAdapter(this);
          mPendingIntent = PendingIntent.getActivity(this, 0, (new Intent(this, this.getClass())).addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP), 0);
          IntentFilter intentFilter = new IntentFilter(NfcAdapter.ACTION_TECH_DISCOVERED);
          mIntentFilters = new IntentFilter[]{intentFilter};
          mTechLists = new String[][]{new String[]{NfcB.class.getName()}};
          setRootPath();
          Conn conn = new NFCConn();
          api = new ReadAPI(this, R.raw.base, R.raw.license, m_RootPath, this, conn);
          ...
      }
  ​
      private void setRootPath() {
          PackageManager packageManager = this.getPackageManager();
          try {
              PackageInfo info = packageManager.getPackageInfo(this.getPackageName(), 0);
              this.m_RootPath = info.applicationInfo.dataDir;
          } catch (NameNotFoundException e) {
              e.printStackTrace();
          }
      }
  ​
  ​
      @Override
      protected void onResume() {
          super.onResume();
        mNfcAdapter.enableForegroundDispatch(this, mPendingIntent, mIntentFilters, mTechLists);
      }
  ​
  ​
      @Override
      protected void onNewIntent(Intent intent) {
          super.onNewIntent(intent);
          Log.e(TAG, "-----------------onNewIntent----------------");
          if (NfcAdapter.ACTION_TECH_DISCOVERED.equals(intent.getAction())) {
              if (api != null) {
                  api.read(intent);
              } else {
                  Log.d(Constants.TAG, "api 未初始化");
              }
          }
      }
  ​
      @Override
      protected void onPause() {
          super.onPause();
          mNfcAdapter.disableForegroundDispatch(this);
      }
  ​
      @Override
      public void error(final int errorCode) {
          ....//错误码
      }
  ​
      @Override
      public void readSuccess(IdCardInfo idCardInfo) {
         ....//读卡成功处理
          updateIdCardInfo(idCardInfo);
      }
  
      @Override
      public void exception(final String ex) {
          Toast.makeText(getApplicationContext(), ex, Toast.LENGTH_SHORT).show();
      }
  ​
     @Override
      public void start() {
          //检测到有卡
      }
  }

• USB读网络身份证

  以下只是最主要的处理流程，具体的还请参考源代码

  <activity
      android:name=".USBTestActivity"
      android:launchMode="singleTop">
      <intent-filter>
          <action android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" />
      </intent-filter>
      <meta-data
          android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED"
          android:resource="@xml/device_filter" />
  </activity>

  ```java
  

  public class DemoActivity extends BaseActivity implements ReadListener{ ​ ......

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_idcard);
        ......
        setRootPath();
        Conn conn = new USBConn(getApplicationContext());
        api = new ReadAPI(getApplicationContext(), R.raw.base, R.raw.license, m_RootPath, this, conn);
    }
  

  ​ @Override public void error(final int errorCode) { //错误码 } ​ @Override public void readSuccess(final IdCardInfo idCardInfo) { //读卡成功 updateIdCardInfo(idCardInfo)； } ​ @Override public void exception(final String ex) { //操作异常 Toast.makeText(getApplicationContext(), ex, Toast.LENGTH_SHORT).show(); } ​ ​ @Override public void start() { //检测到有卡 } }

• 身份证数据说明

  调用方法	说明
  IdCardInfo.getName()	获取姓名
  IdCardInfo.getSex()	获取性别
  IdCardInfo.getNation()	获取名族
  IdCardInfo.getBirthday()	获取出生日期
  IdCardInfo.getAddress()	获取住址
  IdCardInfo.getIdNum()	获取身份证号
  IdCardInfo.getIssue()	获取签证机关
  IdCardInfo.getStartDate()	获取身份证有效起始日期
  IdCardInfo.getEndDate()	获取身份证有效截止日期
  IdCardInfo.getPhoto()	获取身份证头像
  IdCardInfo.getM_FingerModle()	获取身份证指纹模板