Gestionar múltiples AID de Visa

Descripción general

Usa el SDK de NFC Wallet para gestionar varios AID de Visa.

Puedes leer los AID disponibles. También puedes actualizar la prioridad del AID y el estado de bloqueo.

Integración del SDK

Los identificadores de aplicación (AID) se exponen a través de DigitalCard.aidInfoList: [AIDInfo].

Para detectar varios AID, comprueba DigitalCard.isMultiAID: Bool.

Recuperar información del AID

DigitalCard.aidInfoList: [AIDInfo] devuelve un array de AIDInfo objetos.

Cada AIDInfo incluye el AID y metadatos:

• AIDInfo.aid: El AID como Cadena.
• AIDInfo.label: La etiqueta como Cadena.
• AIDInfo.lockStatus: El estado del AID: .locked o .unlocked (predeterminado).

Solo se admiten tarjetas Visa.

Cuando se llama en una tarjeta que no es Visa:

• DigitalCard.isMultiAID siempre devuelve falso.
• DigitalCard.aidInfoList y DigitalCard.setAIDInfoList(_:) lanza clientError.

Un terminal devuelve la palabra de estado 6A81 cuando envía SELECT a un AID bloqueado.

Actualizar la prioridad del AID y el estado de bloqueo

Usa la AIDInfo objetos de aidInfoList cuando construyas una lista actualizada.

AIDInfo.lockStatus es mutable. También puedes reordenar la lista para cambiar la prioridad del AID.

El primer elemento de la lista tiene la máxima prioridad.

Para actualizar la configuración del AID:

1. Usa la DigitalCard.aidInfoList: [AIDInfo] API para recuperar el AIDInfo de la tarjeta digital.
2. Crea un nuevo array y actualiza el orden y/o lockStatus.
3. Aplica la actualización usando DigitalCard.setAIDInfoList(_:).

Al establecer una nueva lista, conserva los mismos AIDInfo elementos.

No añadas, elimines ni cambies los AID o las etiquetas. De lo contrario, DigitalCard.Error.aidInfoListMismatch se lanza.

Ejemplo

Este ejemplo reordena los AID y bloquea un AID.

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

// Reordena los elementos según sea necesario:
newAIDInfoList.append(aidInfoList[3])
newAIDInfoList.append(aidInfoList[0])
newAIDInfoList.append(aidInfoList[1])
newAIDInfoList.append(aidInfoList[2])

// Si los elementos no necesitan reordenarse,
// podemos simplemente crear una nueva copia a partir de la original:
newAIDInfoList = aidInfoList

// Cambia el lockStatus de los AID según sea necesario:
newAIDInfoList[0].lockStatus = .locked
newAIDInfoList[1].lockStatus = .unlocked

// Establece el nuevo array de objetos `AIDInfo` en el digitalCard:
try await digitalCard.setAIDInfoList(newAIDInfoList)

digitalCard.aidInfoList devuelve una copia de AIDInfo.

Modificar el array no actualiza la tarjeta digital. Llama a setAIDInfoList(_:) para que los cambios surtan efecto.