読み出すための準備

このページでは、第一世代在留カードからデータの読み出しを行うための準備を行います。

SDK の準備

第一世代在留カードからデータを読み出すためには、このカードからの読み出しに対応した SDK が必要になります。

iOS

iOS の場合、第一世代在留カードからのデータ読み出しに対応した SDK は VerifyResidenceCardMock パッケージになります。 SDK の URL を入力する際には、 https://repo.platform.p8n.app/VerifyResidenceCardMock/と入力してください。

Swift で第一世代在留カードからのデータ読み出しに対応した SDK を利用する際には、以下のようにインポートしてください。

import SwiftUI
import VerifyBaseShared
import VerifyBaseMock
import VerifyResidenceCardShared
import VerifyResidenceCardMock

func run(password: String) async throws -> String {
  // 在留カードへの接続準備を行います。
  let session = ReaderSession(dispatchQueue: DispatchQueue.main)

  // ここに実装を追加します。

  session.close()
  return "not implemented"
}
  /* ... */

Android

Android の場合、第一世代在留カードからのデータ読み出しに対応した SDK は jp.co.pocketsign.verify.mock.residencecard パッケージになります。 例えば、jp.co.pocketsign.verify.mock.residencecard.ResidenceCard などのクラスがパッケージに含まれます。

具体的なクラスは、SDK リファレンスをご覧ください。

dependencies へ以下のように依存関係を追加してください。

  implementation "jp.co.pocketsign.verify:base-shared:$verifySdkVersion"
  implementation "jp.co.pocketsign.verify:base-mock:$verifySdkVersion"
  implementation "jp.co.pocketsign.verify:residencecard-shared:$verifySdkVersion"
  implementation "jp.co.pocketsign.verify:residencecard-mock:$verifySdkVersion"

Kotlin で第一世代在留カードからのデータ読み出しを行う際には、以下のように対応するクラスをインポートしてください。

import jp.co.pocketsign.verify.mock.reader.ReaderSession
import jp.co.pocketsign.verify.mock.residencecard.ResidenceCard

class MainActivity : ComponentActivity() {

  suspend fun run(password: String): String {
    // 在留カードへの接続準備を行います。
    val session = ReaderSession(this, this)

    // ここに実装を追加します。

    session.close()
    return "not implemented"
  }
  /* ... */
}

Web（PaSoRi）

準備中

Web（PaSoRi）での第一世代在留カードからのデータ読み出し機能は現在準備中です。

Flutter

準備中

Flutter での第一世代在留カードからのデータ読み出し機能は現在準備中です。

React Native

準備中

React Native での第一世代在留カードからのデータ読み出し機能は現在準備中です。

API の準備

読み取ったデータから写真などの情報を取得するためには、 Verify API が提供している Verify CardInfo API を用いて、 データのパースを行う必要があります。

テナントを作成した段階では、 この Verify CardInfo API は無効化されているため利用できません。

Verify CardInfo API の一部である在留カード用 API を利用するには、お問い合わせより、 在留カード用 API の利用についてご相談ください。