Tag Classe

Definição

[Android.Runtime.Register("android/nfc/Tag", DoNotGenerateAcw=true)]
public sealed class Tag : Java.Lang.Object, Android.OS.IParcelable, IDisposable

[<Android.Runtime.Register("android/nfc/Tag", DoNotGenerateAcw=true)>]
type Tag = class
    inherit Object
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Herança

Object

JavaObject

Object

Tag

Atributos

RegisterAttribute

Implementações

IParcelable IJavaObject IJavaPeerable IDisposable

Comentários

Representa uma marca NFC que foi descoberta.

Tag é um objeto imutável que representa o estado de uma marca NFC no momento da descoberta. Ele pode ser usado como um identificador para TagTechnology classes para executar operações avançadas ou consultado diretamente para sua ID por meio #getId do conjunto de tecnologias que ele contém por meio #getTechListde . As matrizes passadas e retornadas por essa classe são <>clonadas e<>, portanto, tenha cuidado para não modificá-las.

Um novo objeto de marca é criado sempre que uma marca é descoberta (entra no intervalo), mesmo que seja a mesma marca física. Se uma marca for removida e retornada para o intervalo, somente o objeto de marca mais recente poderá ser usado com êxito para criar um TagTechnology.

<h3>Tag Dispatch</h3> Quando uma marca é descoberta, um Tag objeto é criado e passado para uma única atividade por meio do NfcAdapter#EXTRA_TAG extra em um android.content.Intent via Context#startActivity. Uma expedição de quatro estágios é usada para selecionar a atividade mais apropriada para manipular a marca. O sistema operacional Android executa cada estágio em ordem e conclui a expedição assim que uma única atividade correspondente é encontrada. Se houver várias atividades correspondentes encontradas em qualquer estágio, a caixa de diálogo do seletor de atividades do Android será mostrada para permitir que o usuário selecione a atividade para receber a marca.

O mecanismo de expedição de marca foi projetado para dar uma alta probabilidade de expedição de uma marca para a atividade correta sem mostrar ao usuário uma caixa de diálogo do seletor de atividades. Isso é importante para interações nfc porque elas são muito transitórias. Se um usuário precisar mover o dispositivo Android para escolher um aplicativo, a conexão provavelmente será interrompida.

<h4>1. Expedição< de atividade em primeiro plano/h4> Uma atividade em primeiro plano que chamou NfcAdapter#enableForegroundDispatch NfcAdapter.enableForegroundDispatch() é dada prioridade. Consulte a documentação sobre NfcAdapter#enableForegroundDispatch NfcAdapter.enableForegroundDispatch() seu uso. <h4>2. Expedição< de dados NDEF/h4> Se a marca contiver dados NDEF, o sistema inspecionará o primeiro NdefRecord no primeiro NdefMessage. Se o registro for um URI, o SmartPoster ou os dados Context#startActivity MIME serão chamados com NfcAdapter#ACTION_NDEF_DISCOVERED. Para registros de URI e SmartPoster, o URI é colocado no campo de dados da intenção. Para registros MIME, o tipo MIME é colocado no campo de tipo da intenção. Isso permite que as atividades de registro sejam iniciadas somente quando os dados que eles sabem como manipular estiverem presentes em uma marca. Esse é o método preferencial de manipulação de dados em uma marca, pois os dados NDEF podem ser armazenados em muitos tipos de marcas e não dependem de uma tecnologia de marca específica. Consulte NfcAdapter#ACTION_NDEF_DISCOVEREDpara obter mais detalhes. Se a marca não contiver dados NDEF ou se nenhuma atividade for registrada com NfcAdapter#ACTION_NDEF_DISCOVERED um URI de dados correspondente ou tipo MIME, a expedição passará para o estágio 3. <h4>3. Tag Technology dispatch</h4>Context#startActivity é chamado NfcAdapter#ACTION_TECH_DISCOVERED para expedir a marca para uma atividade que pode lidar com as tecnologias presentes na marca. As tecnologias são definidas como subconsultas do TagTechnologypacote android.nfc.tech. O sistema operacional Android procura uma atividade que possa lidar com uma ou mais tecnologias na marca. Consulte NfcAdapter#ACTION_TECH_DISCOVEREDpara obter mais detalhes. <h4>4. Expedição< de fall-back/h4> Se nenhuma atividade tiver sido correspondida, então Context#startActivity será chamada com NfcAdapter#ACTION_TAG_DISCOVERED. Isso se destina a um mecanismo de fall-back. Consulte NfcAdapter#ACTION_TAG_DISCOVERED.

<h3>NFC Tag Background</h3> Uma marca NFC é um dispositivo NFC passivo, alimentado pelo campo NFC deste dispositivo Android enquanto ele está no intervalo. As marcas podem vir de várias formas, como adesivos, cartões, chaves ou até mesmo inseridas em um dispositivo mais sofisticado.

As marcas podem ter uma ampla gama de recursos. Marcas simples oferecem apenas semântica de leitura/gravação e contêm algumas áreas programáveis únicas para tornar somente leitura. Marcas mais complexas oferecem operações matemáticas e controle de acesso por setor e autenticação. As marcas mais sofisticadas contêm ambientes operacionais que permitem interações complexas com o código em execução na marca. Use TagTechnology classes para acessar uma ampla gama de recursos disponíveis em marcas NFC.

Java documentação para android.nfc.Tag.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.