Interagir com dispositivos NFC no Chrome para Android

Agora é possível ler e gravar em tags NFC.

François Beaufort
François Beaufort

O que é a NFC na Web?

NFC significa "Comunicação a curta distância", uma tecnologia sem fio de curto alcance que opera a 13,56 MHz e permite a comunicação entre dispositivos a uma distância menor que 10 cm e uma taxa de transmissão de até 424 kbit/s.

O NFC da Web permite que os sites leiam e gravem em tags NFC quando elas estão perto do dispositivo do usuário (geralmente a 5 a 10 cm). O escopo atual é limitado ao formato de troca de dados do NFC (NDEF), um formato de mensagem binária leve que funciona em diferentes formatos de tags.

Smartphone com uma tag NFC para trocar dados
Diagrama de uma operação de NFC

Casos de uso sugeridos

O NFC da Web é limitado ao NDEF porque as propriedades de segurança de leitura e gravação de dados NDEF são mais fáceis de quantificar. Não há suporte para operações de E/S de baixo nível (por exemplo, ISO-DEP, NFC-A/B, NFC-F), modo de comunicação ponto a ponto e emulação de cartão com base em host (HCE, na sigla em inglês).

Exemplos de sites que podem usar NFC para Web incluem:

  • Museus e galerias de arte podem mostrar mais informações sobre uma exibição quando o usuário encosta o dispositivo em um cartão NFC perto da exposição.
  • Os sites de gerenciamento de inventário podem ler ou gravar dados na tag NFC de um contêiner para atualizar as informações sobre o conteúdo.
  • Os sites de conferências podem usá-lo para ler os cartões NFC durante o evento e garantir que eles estejam bloqueados para evitar mais mudanças nas informações gravadas neles.
  • Os sites podem usá-lo para compartilhar secrets iniciais necessários para cenários de provisionamento de dispositivos ou serviços e também para implantar dados de configuração no modo operacional.
Smartphone lendo várias tags NFC
Gerenciamento de inventário de NFC ilustrado

Status atual

Etapa Status
1. Criar explicação Concluído
2. Criar um rascunho inicial da especificação Concluído
3. Coletar feedback e iterar o design Concluído
4. Teste de origem Concluído
5. Lançar Concluído

Usar NFC na Web

Detecção de recursos

A detecção de recursos para hardware é diferente do que você provavelmente está acostumado. A presença de NDEFReader informa que o navegador oferece suporte a NFC para Web, mas não se o hardware necessário está presente. Especificamente, se o hardware estiver ausente, a promessa retornada por determinadas chamadas será rejeitada. Vou fornecer detalhes ao descrever NDEFReader.

if ('NDEFReader' in window) { /* Scan and write NFC tags */ }

Terminologia

Uma tag NFC é um dispositivo NFC passivo, ou seja, é alimentada por indução magnética quando um dispositivo NFC ativo (como um smartphone) está por perto. As tags NFC existem em várias formas e modelos, como adesivos, cartões de crédito, pulsos de braço e muito mais.

Foto de uma tag NFC transparente
Uma tag NFC transparente

O objeto NDEFReader é o ponto de entrada no NFC da Web que expõe a funcionalidade para preparar ações de leitura e/ou gravação que são cumpridas quando uma tag NDEF está próxima. O NDEF em NDEFReader significa formato de troca de dados do NFC, um formato de mensagem binária leve padronizado pelo NFC Forum.

O objeto NDEFReader atua sobre mensagens NDEF recebidas de tags NFC e grava mensagens NDEF em tags NFC dentro do alcance.

Uma tag NFC compatível com NDEF é como um post-it. Qualquer pessoa pode ler e, a menos que seja somente leitura, qualquer pessoa pode gravar nele. Ele contém uma única mensagem NDEF que encapsula um ou mais registros NDEF. Cada registro NDEF é uma estrutura binária que contém um payload de dados e informações de tipo associadas. O NFC da Web oferece suporte aos seguintes tipos de registro padronizados do NFC Forum: vazio, texto, URL, cartaz inteligente, tipo MIME, URL absoluto, tipo externo, tipo desconhecido e tipo local.

Diagrama de uma mensagem NDEF
Diagrama de uma mensagem NDEF

Verificar tags NFC

Para fazer a leitura de tags NFC, primeiro instancie um novo objeto NDEFReader. Chamar scan() retorna uma promessa. O usuário poderá receber uma solicitação se o acesso não tiver sido concedido anteriormente. A promessa será resolvida se as seguintes condições forem atendidas:

  • Ele só foi chamado em resposta a um gesto do usuário, como um gesto de toque ou clique do mouse.
  • O usuário permitiu que o site interagisse com dispositivos NFC.
  • O smartphone do usuário é compatível com NFC.
  • O usuário ativou a NFC no smartphone.

Depois que a promessa é resolvida, as mensagens NDEF recebidas ficam disponíveis se inscrevam em eventos reading por um listener de eventos. Você também precisa se inscrever em eventos readingerror para receber notificações quando tags NFC incompatíveis estiverem próximas.

const ndef = new NDEFReader();
ndef.scan().then(() => {
  console.log("Scan started successfully.");
  ndef.onreadingerror = () => {
    console.log("Cannot read data from the NFC tag. Try another one?");
  };
  ndef.onreading = event => {
    console.log("NDEF message read.");
  };
}).catch(error => {
  console.log(`Error! Scan failed to start: ${error}.`);
});

Quando uma tag NFC está próxima, um evento NDEFReadingEvent é acionado. Ele contém duas propriedades exclusivas:

  • serialNumber representa o número de série do dispositivo (por exemplo, 00-11-22-33-44-55-66) ou uma string vazia se nenhuma estiver disponível.
  • message representa a mensagem NDEF armazenada na tag NFC.

Para ler o conteúdo da mensagem NDEF, faça um loop em message.records e processe os membros data adequadamente com base no recordType. O membro data é exposto como um DataView, já que permite processar casos em que os dados são codificados em UTF-16.

ndef.onreading = event => {
  const message = event.message;
  for (const record of message.records) {
    console.log("Record type:  " + record.recordType);
    console.log("MIME type:    " + record.mediaType);
    console.log("Record id:    " + record.id);
    switch (record.recordType) {
      case "text":
        // TODO: Read text record with record data, lang, and encoding.
        break;
      case "url":
        // TODO: Read URL record with record data.
        break;
      default:
        // TODO: Handle other records with record data.
    }
  }
};

Gravar tags NFC

Para gravar tags NFC, primeiro instancie um novo objeto NDEFReader. Chamar write() retorna uma promessa. O usuário pode receber uma solicitação se o acesso não foi concedido anteriormente. Nesse ponto, uma mensagem NDEF é "preparada" e a promessa será resolvida se todas as condições a seguir forem atendidas:

  • Ele só era chamado em resposta a um gesto do usuário, como um gesto de toque ou um clique do mouse.
  • O usuário permitiu que o site interagisse com dispositivos NFC.
  • O smartphone do usuário é compatível com NFC.
  • O usuário ativou a NFC no smartphone.
  • O usuário tocou em uma tag NFC e uma mensagem NDEF foi gravada com sucesso.

Para gravar texto em uma tag NFC, transmita uma string para o método write().

const ndef = new NDEFReader();
ndef.write(
  "Hello World"
).then(() => {
  console.log("Message written.");
}).catch(error => {
  console.log(`Write failed :-( try again: ${error}.`);
});

Para gravar um registro de URL em uma tag NFC, transmita um dicionário que represente uma mensagem NDEF para write(). No exemplo abaixo, a mensagem NDEF é um dicionário com uma chave records. O valor dela é uma matriz de registros. Nesse caso, um registro de URL definido como um objeto com uma chave recordType definida como "url" e uma chave data definida como a string de URL.

const ndef = new NDEFReader();
ndef.write({
  records: [{ recordType: "url", data: "https://w3c.github.io/web-nfc/" }]
}).then(() => {
  console.log("Message written.");
}).catch(error => {
  console.log(`Write failed :-( try again: ${error}.`);
});

Também é possível gravar vários registros em uma tag NFC.

const ndef = new NDEFReader();
ndef.write({ records: [
    { recordType: "url", data: "https://w3c.github.io/web-nfc/" },
    { recordType: "url", data: "https://web.dev/nfc/" }
]}).then(() => {
  console.log("Message written.");
}).catch(error => {
  console.log(`Write failed :-( try again: ${error}.`);
});

Se a tag NFC contiver uma mensagem NDEF que não precisa ser substituída, defina a propriedade overwrite como false nas opções transmitidas ao método write(). Nesse caso, a promessa retornada será rejeitada se uma mensagem NDEF já estiver armazenada na tag NFC.

const ndef = new NDEFReader();
ndef.write("Writing data on an empty NFC tag is fun!", { overwrite: false })
.then(() => {
  console.log("Message written.");
}).catch(error => {
  console.log(`Write failed :-( try again: ${error}.`);
});

Tornar as tags NFC somente leitura

Para impedir que usuários mal-intencionados substituam o conteúdo de uma tag NFC, é possível tornar as tags NFC permanentemente somente leitura. Essa operação é um processo unilateral e não pode ser revertida. Depois que uma tag NFC é definida como somente leitura, não é mais possível gravar nela.

Para tornar as tags NFC somente leitura, primeiro instancie um novo objeto NDEFReader. Chamar makeReadOnly() retorna uma promessa. O usuário poderá receber uma solicitação se o acesso não tiver sido concedido anteriormente. A promessa será resolvida se todas as condições a seguir forem atendidas:

  • Ele só foi chamado em resposta a um gesto do usuário, como um gesto de toque ou clique do mouse.
  • O usuário permitiu que o site interagisse com dispositivos NFC.
  • O smartphone do usuário é compatível com NFC.
  • O usuário ativou a NFC no smartphone.
  • O usuário tocou em uma tag NFC e ela foi definida como somente leitura.
const ndef = new NDEFReader();
ndef.makeReadOnly()
.then(() => {
  console.log("NFC tag has been made permanently read-only.");
}).catch(error => {
  console.log(`Operation failed: ${error}`);
});

Veja como tornar uma tag NFC permanentemente somente leitura depois de gravar nela.

const ndef = new NDEFReader();
try {
  await ndef.write("Hello world");
  console.log("Message written.");
  await ndef.makeReadOnly();
  console.log("NFC tag has been made permanently read-only after writing to it.");
} catch (error) {
  console.log(`Operation failed: ${error}`);
}

Como makeReadOnly() está disponível no Android no Chrome 100 ou versões mais recentes, verifique se esse recurso tem suporte com o seguinte:

if ("NDEFReader" in window && "makeReadOnly" in NDEFReader.prototype) {
  // makeReadOnly() is supported.
}

Segurança e permissões

A equipe do Chrome projetou e implementou o NFC da Web usando os princípios básicos definidos em Como controlar o acesso a recursos poderosos da plataforma da Web, incluindo controle do usuário, transparência e ergonomia.

Como o NFC expande o domínio de informações potencialmente disponíveis para sites maliciosos, a disponibilidade do NFC é restrita para maximizar o conhecimento e o controle dos usuários sobre o uso do NFC.

Captura de tela de uma solicitação de NFC na Web em um site
Solicitação do usuário do NFC da Web

O NFC da Web só está disponível para frames de nível superior e contextos de navegação seguros (somente HTTPS). As origens precisam primeiro solicitar a permissão "nfc" ao processar um gesto do usuário (por exemplo, um clique no botão). Os métodos NDEFReader scan(), write() e makeReadOnly() acionam uma solicitação ao usuário se o acesso não tiver sido concedido anteriormente.

  document.querySelector("#scanButton").onclick = async () => {
    const ndef = new NDEFReader();
    // Prompt user to allow website to interact with NFC devices.
    await ndef.scan();
    ndef.onreading = event => {
      // TODO: Handle incoming NDEF messages.
    };
  };

A combinação de uma solicitação de permissão iniciada pelo usuário e o movimento físico real de trazer o dispositivo para uma tag NFC de destino reflete o padrão de escolha encontrado nas outras APIs de acesso a arquivos e dispositivos.

Para realizar uma verificação ou gravação, a página da Web precisa estar visível quando o usuário tocar em uma tag NFC com o dispositivo. O navegador usa o retorno tátil para indicar um toque. O acesso ao rádio NFC é bloqueado se a tela estiver desligada ou o dispositivo estiver bloqueado. Para páginas da Web não visíveis, o recebimento e o envio de conteúdo NFC são interrompidos e retomados quando uma página da Web fica visível novamente.

Graças à API Page Visibility, é possível acompanhar quando a visibilidade do documento muda.

document.onvisibilitychange = event => {
  if (document.hidden) {
    // All NFC operations are automatically suspended when document is hidden.
  } else {
    // All NFC operations are resumed, if needed.
  }
};

Manual

Veja alguns exemplos de código para você começar.

Verificar a permissão

A API Permissions permite verificar se a permissão "nfc" foi concedida. Este exemplo mostra como ler tags NFC sem interação do usuário se o acesso foi concedido anteriormente ou mostra um botão. O mesmo mecanismo funciona para gravar tags NFC, já que usa a mesma permissão em segundo plano.

const ndef = new NDEFReader();

async function startScanning() {
  await ndef.scan();
  ndef.onreading = event => {
    /* handle NDEF messages */
  };
}

const nfcPermissionStatus = await navigator.permissions.query({ name: "nfc" });
if (nfcPermissionStatus.state === "granted") {
  // NFC access was previously granted, so we can start NFC scanning now.
  startScanning();
} else {
  // Show a "scan" button.
  document.querySelector("#scanButton").style.display = "block";
  document.querySelector("#scanButton").onclick = event => {
    // Prompt user to allow UA to send and receive info when they tap NFC devices.
    startScanning();
  };
}

Cancelar operações de NFC

O uso do primitivo AbortController facilita o cancelamento de operações NFC. O exemplo abaixo mostra como transmitir o signal de um AbortController pelas opções dos métodos scan(), makeReadOnly() e write() do NDEFReader e interromper as duas operações de NFC ao mesmo tempo.

const abortController = new AbortController();
abortController.signal.onabort = event => {
  // All NFC operations have been aborted.
};

const ndef = new NDEFReader();
await ndef.scan({ signal: abortController.signal });

await ndef.write("Hello world", { signal: abortController.signal });
await ndef.makeReadOnly({ signal: abortController.signal });

document.querySelector("#abortButton").onclick = event => {
  abortController.abort();
};

Leitura após gravação

O uso de write() e scan() com a primitiva AbortController permite ler uma tag NFC depois de gravar uma mensagem nela. O exemplo abaixo mostra como gravar uma mensagem de texto em uma tag NFC e ler a nova mensagem na tag NFC. A verificação é interrompida após três segundos.

// Waiting for user to tap NFC tag to write to it...
const ndef = new NDEFReader();
await ndef.write("Hello world");
// Success! Message has been written.

// Now scanning for 3 seconds...
const abortController = new AbortController();
await ndef.scan({ signal: abortController.signal });
const message = await new Promise((resolve) => {
  ndef.onreading = (event) => resolve(event.message);
});
// Success! Message has been read.

await new Promise((r) => setTimeout(r, 3000));
abortController.abort();
// Scanning is now stopped.

Ler e gravar um registro de texto

O registro de texto data pode ser decodificado com um TextDecoder instanciado com a propriedade encoding do registro. A linguagem do registro de texto está disponível na propriedade lang.

function readTextRecord(record) {
  console.assert(record.recordType === "text");
  const textDecoder = new TextDecoder(record.encoding);
  console.log(`Text: ${textDecoder.decode(record.data)} (${record.lang})`);
}

Para gravar um registro de texto simples, transmita uma string ao método write() do NDEFReader.

const ndef = new NDEFReader();
await ndef.write("Hello World");

Os registros de texto são UTF-8 por padrão e assumem o idioma do documento atual, mas ambas as propriedades (encoding e lang) podem ser especificadas usando a sintaxe completa para criar um registro NDEF personalizado.

function a2utf16(string) {
  let result = new Uint16Array(string.length);
  for (let i = 0; i < string.length; i++) {
    result[i] = string.codePointAt(i);
  }
  return result;
}

const textRecord = {
  recordType: "text",
  lang: "fr",
  encoding: "utf-16",
  data: a2utf16("Bonjour, François !")
};

const ndef = new NDEFReader();
await ndef.write({ records: [textRecord] });

Ler e gravar um registro de URL

Use TextDecoder para decodificar o data do registro.

function readUrlRecord(record) {
  console.assert(record.recordType === "url");
  const textDecoder = new TextDecoder();
  console.log(`URL: ${textDecoder.decode(record.data)}`);
}

Para gravar um registro de URL, transmita um dicionário de mensagens NDEF para o método write() do NDEFReader. O registro de URL contido na mensagem NDEF é definido como um objeto com uma chave recordType definida como "url" e uma chave data definida como a string de URL.

const urlRecord = {
  recordType: "url",
  data:"https://w3c.github.io/web-nfc/"
};

const ndef = new NDEFReader();
await ndef.write({ records: [urlRecord] });

Ler e gravar um registro do tipo MIME

A propriedade mediaType de um registro de tipo MIME representa o tipo MIME do payload do registro NDEF para que data possa ser decodificado corretamente. Por exemplo, use JSON.parse para decodificar o texto JSON e um elemento Image para decodificar os dados da imagem.

function readMimeRecord(record) {
  console.assert(record.recordType === "mime");
  if (record.mediaType === "application/json") {
    const textDecoder = new TextDecoder();
    console.log(`JSON: ${JSON.parse(decoder.decode(record.data))}`);
  }
  else if (record.mediaType.startsWith('image/')) {
    const blob = new Blob([record.data], { type: record.mediaType });
    const img = new Image();
    img.src = URL.createObjectURL(blob);
    document.body.appendChild(img);
  }
  else {
    // TODO: Handle other MIME types.
  }
}

Para gravar um registro de tipo MIME, transmita um dicionário de mensagem NDEF para o método write() do NDEFReader. O registro de tipo MIME contido na mensagem NDEF é definido como um objeto com uma chave recordType definida como "mime", uma chave mediaType definida como o tipo MIME real do conteúdo e uma chave data definida como um objeto que pode ser um ArrayBuffer ou fornecer uma visualização em um ArrayBuffer (por exemplo, Uint8Array, DataView).

const encoder = new TextEncoder();
const data = {
  firstname: "François",
  lastname: "Beaufort"
};
const jsonRecord = {
  recordType: "mime",
  mediaType: "application/json",
  data: encoder.encode(JSON.stringify(data))
};

const imageRecord = {
  recordType: "mime",
  mediaType: "image/png",
  data: await (await fetch("icon1.png")).arrayBuffer()
};

const ndef = new NDEFReader();
await ndef.write({ records: [jsonRecord, imageRecord] });

Ler e gravar um registro de URL absoluto

O registro de URL absoluto data pode ser decodificado com um TextDecoder simples.

function readAbsoluteUrlRecord(record) {
  console.assert(record.recordType === "absolute-url");
  const textDecoder = new TextDecoder();
  console.log(`Absolute URL: ${textDecoder.decode(record.data)}`);
}

Para gravar um registro de URL absoluto, transmita um dicionário de mensagens NDEF para o método write() do NDEFReader. O registro de URL absoluto contido na mensagem NDEF é definido como um objeto com uma chave recordType definida como "absolute-url" e uma chave data definida como a string de URL.

const absoluteUrlRecord = {
  recordType: "absolute-url",
  data:"https://w3c.github.io/web-nfc/"
};

const ndef = new NDEFReader();
await ndef.write({ records: [absoluteUrlRecord] });

Ler e gravar um registro de cartaz inteligente

Um registro de cartaz inteligente (usado em anúncios de revistas, panfletos, outdoors etc.) descreve algum conteúdo da Web como um registro NDEF que contém uma mensagem NDEF como payload. Chame record.toRecords() para transformar data em uma lista de registros contidos no registro inteligente de cartaz. Ele precisa ter um registro de URL, um registro de texto para o título, um registro de tipo MIME para a imagem e alguns registros de tipo local personalizados, como ":t", ":act" e ":s", respectivamente, para o tipo, a ação e o tamanho do registro de pôster inteligente.

Os registros de tipo local são exclusivos apenas no contexto local do registro NDEF que os contém. Use-os quando o significado dos tipos não for importante fora do contexto local do registro que os contém e quando o uso de armazenamento for uma restrição rígida. Os nomes dos registros de tipo local sempre começam com : no Web NFC (por exemplo, ":t", ":s", ":act"). Isso serve para diferenciar um registro de texto de um registro de texto de tipo local, por exemplo.

function readSmartPosterRecord(smartPosterRecord) {
  console.assert(record.recordType === "smart-poster");
  let action, text, url;

  for (const record of smartPosterRecord.toRecords()) {
    if (record.recordType == "text") {
      const decoder = new TextDecoder(record.encoding);
      text = decoder.decode(record.data);
    } else if (record.recordType == "url") {
      const decoder = new TextDecoder();
      url = decoder.decode(record.data);
    } else if (record.recordType == ":act") {
      action = record.data.getUint8(0);
    } else {
      // TODO: Handle other type of records such as `:t`, `:s`.
    }
  }

  switch (action) {
    case 0:
      // Do the action
      break;
    case 1:
      // Save for later
      break;
    case 2:
      // Open for editing
      break;
  }
}

Para gravar um registro de cartaz inteligente, transmita uma mensagem NDEF para o método write() do NDEFReader. O registro de cartaz inteligente contido na mensagem NDEF é definido como um objeto com uma chave recordType definida como "smart-poster" e uma chave data definida como um objeto que representa (mais uma vez) uma mensagem NDEF contida no registro de cartaz inteligente.

const encoder = new TextEncoder();
const smartPosterRecord = {
  recordType: "smart-poster",
  data: {
    records: [
      {
        recordType: "url", // URL record for smart poster content
        data: "https://my.org/content/19911"
      },
      {
        recordType: "text", // title record for smart poster content
        data: "Funny dance"
      },
      {
        recordType: ":t", // type record, a local type to smart poster
        data: encoder.encode("image/gif") // MIME type of smart poster content
      },
      {
        recordType: ":s", // size record, a local type to smart poster
        data: new Uint32Array([4096]) // byte size of smart poster content
      },
      {
        recordType: ":act", // action record, a local type to smart poster
        // do the action, in this case open in the browser
        data: new Uint8Array([0])
      },
      {
        recordType: "mime", // icon record, a MIME type record
        mediaType: "image/png",
        data: await (await fetch("icon1.png")).arrayBuffer()
      },
      {
        recordType: "mime", // another icon record
        mediaType: "image/jpg",
        data: await (await fetch("icon2.jpg")).arrayBuffer()
      }
    ]
  }
};

const ndef = new NDEFReader();
await ndef.write({ records: [smartPosterRecord] });

Ler e gravar um registro de tipo externo

Para criar registros definidos pelo aplicativo, use registros de tipo externo. Eles podem conter uma mensagem NDEF como payload acessível com toRecords(). O nome deles contém o nome de domínio da organização emissora, dois-pontos e um nome de tipo com pelo menos um caractere, por exemplo, "example.com:foo".

function readExternalTypeRecord(externalTypeRecord) {
  for (const record of externalTypeRecord.toRecords()) {
    if (record.recordType == "text") {
      const decoder = new TextDecoder(record.encoding);
      console.log(`Text: ${textDecoder.decode(record.data)} (${record.lang})`);
    } else if (record.recordType == "url") {
      const decoder = new TextDecoder();
      console.log(`URL: ${decoder.decode(record.data)}`);
    } else {
      // TODO: Handle other type of records.
    }
  }
}

Para gravar um registro de tipo externo, transmita um dicionário de mensagens NDEF para o método write() do NDEFReader. O registro de tipo externo contido na mensagem NDEF é definido como um objeto com uma chave recordType definida como o nome do tipo externo e uma chave data definida como um objeto que representa uma mensagem NDEF no registro de tipo externo. A chave data também pode ser ArrayBuffer ou fornecer uma visualização de uma ArrayBuffer (por exemplo, Uint8Array, DataView).

const externalTypeRecord = {
  recordType: "example.game:a",
  data: {
    records: [
      {
        recordType: "url",
        data: "https://example.game/42"
      },
      {
        recordType: "text",
        data: "Game context given here"
      },
      {
        recordType: "mime",
        mediaType: "image/png",
        data: await (await fetch("image.png")).arrayBuffer()
      }
    ]
  }
};

const ndef = new NDEFReader();
ndef.write({ records: [externalTypeRecord] });

Ler e gravar um registro vazio

Um registro vazio não tem payload.

Para gravar um registro vazio, transmita um dicionário de mensagens NDEF para o método write() do NDEFReader. O registro vazio contido na mensagem NDEF é definido como um objeto com uma chave recordType definida como "empty".

const emptyRecord = {
  recordType: "empty"
};

const ndef = new NDEFReader();
await ndef.write({ records: [emptyRecord] });

Suporte ao navegador

O NFC da Web está disponível no Android no Chrome 89.

Dicas para desenvolvedores

Confira uma lista de coisas que eu gostaria de saber quando comecei a usar o Web NFC:

  • O Android processa tags NFC no nível do SO antes que a NFC para Web entre em operação.
  • Você pode encontrar um ícone de NFC em material.io.
  • Use o registro NDEF id para identificar facilmente um registro quando necessário.
  • Uma tag NFC não formatada que oferece suporte a NDEF contém um único registro do tipo vazio.
  • É fácil gravar um registro de aplicativo Android, conforme mostrado abaixo.
const encoder = new TextEncoder();
const aarRecord = {
  recordType: "android.com:pkg",
  data: encoder.encode("com.example.myapp")
};

const ndef = new NDEFReader();
await ndef.write({ records: [aarRecord] });

Demonstrações

Teste o exemplo oficial e confira algumas demonstrações legais de NFC da Web:

Demonstração de cartões NFC para Web no Chrome Dev Summit 2019

Feedback

O Grupo da comunidade da Web NFC e a equipe do Chrome gostariam de saber sua opinião e experiência com a Web NFC.

Fale sobre o design da API

Há algo na API que não funciona como esperado? Ou há métodos ou propriedades ausentes que você precisa implementar sua ideia?

Envie um problema de especificação no repositório do GitHub do Web NFC ou adicione sua opinião a um problema existente.

Informar um problema com a implementação

Você encontrou um bug na implementação do Chrome? Ou a implementação é diferente da especificação?

Registre um bug em https://new.crbug.com. Inclua o máximo de detalhes possível, forneça instruções simples para reproduzir o bug e defina Components como Blink>NFC. O Glitch (link em inglês) funciona muito bem para compartilhar reproduções rápidas e fáceis.

Mostrar apoio

Você pretende usar a NFC na Web? Seu apoio público ajuda a equipe do Chrome a priorizar recursos e mostra a outros fornecedores de navegadores a importância de oferecer suporte a eles.

Envie um tweet para @ChromiumDev usando a hashtag #WebNFC e nos informe onde e como você está usando.

Links úteis

Agradecimentos

Agradecemos muito aos profissionais da Intel pela implementação do NFC na Web. O Google Chrome depende de uma comunidade de committers trabalhando em conjunto para avançar no projeto Chromium. Nem todos os colaboradores do Chromium são Googlers, e esses colaboradores merecem um reconhecimento especial.