Visaの複数AIDを処理する

概要

Visaの複数AIDを扱うにはNFC Wallet SDKを使用します。

利用可能なAIDを読み取れます。AIDの優先度とロック状態も更新できます。

SDK 統合

アプリケーション識別子（AID）は次を通じて公開されます DigitalCard.aidInfoList: [AIDInfo].

複数AIDを検出するには、次を確認してください DigitalCard.isMultiAID: Bool.

AID情報を取得する

DigitalCard.aidInfoList: [AIDInfo] 配列を返します AIDInfo オブジェクト。

各 AIDInfo にはAIDとメタデータが含まれます：

• AIDInfo.aid: AIDを 文字列.

• AIDInfo.label: ラベルを 文字列.

• AIDInfo.lockStatus: AIDの状態： .locked または .unlocked （デフォルト）。

サポートされるのはVisaカードのみです。

非Visaカードで呼び出された場合：

• DigitalCard.isMultiAID は常に返します false.

• DigitalCard.aidInfoList および DigitalCard.setAIDInfoList(_:） をスローします clientError.

端末はステータスワードを返します 6A81 を送信するときに SELECT ロックされたAIDに対して。

AIDの優先度とロック状態を更新する

次を使用してください AIDInfo オブジェクトを aidInfoList から更新されたリストを構築するときに。

AIDInfo.lockStatus は変更可能です。AIDの優先度を変更するためにリストの並べ替えもできます。

リストの最初の要素が最も高い優先度を持ちます。

AID構成を更新するには：

1. 次を使用してください DigitalCard.aidInfoList: [AIDInfo] デジタルカードから AIDInfo を取得するAPI。

2. 新しい配列を作成し、順序および/またはを更新します lockStatus.

3. を使用して更新を適用します DigitalCard.setAIDInfoList(_:）.

新しいリストを設定する場合、同じ AIDInfo 要素を維持してください。

AIDやラベルを追加、削除、変更しないでください。さもなければ、 DigitalCard.Error.aidInfoListMismatch がスローされます。

例

この例ではAIDの順序を変更し、1つのAIDをロックします。

var aidInfoList = try await digitalCard.aidInfoList
let isMultiAID = try await digitalCard.isMultiAID
  
var newAIDInfoList: [AIDInfo] = []

// 必要に応じて項目の順序を入れ替えます：
newAIDInfoList.append(aidInfoList[3])
newAIDInfoList.append(aidInfoList[0])
newAIDInfoList.append(aidInfoList[1])
newAIDInfoList.append(aidInfoList[2])

// 項目の並べ替えが不要な場合、
// 元の配列から新しいコピーを作成できます：
newAIDInfoList = aidInfoList

// 必要に応じてAIDのlockStatusを変更します：
newAIDInfoList[0].lockStatus = .locked
newAIDInfoList[1].lockStatus = .unlocked

// `AIDInfo`オブジェクトの新しい配列をdigitalCardに設定します：
try await digitalCard.setAIDInfoList(newAIDInfoList)

digitalCard.aidInfoList のコピーを返します AIDInfo.

配列を変更してもデジタルカードは更新されません。呼び出してください setAIDInfoList(_:） 変更を有効にするため。