標(biāo)準(zhǔn)NFC-Tag TagSession

導(dǎo)入模塊

import tag from '@ohos.nfc.tag';

tagSession

tagSession是所有NFC Tag技術(shù)類型的基類， 提供建立連接和發(fā)送數(shù)據(jù)等共同接口。

需要通過(guò)其子類來(lái)訪問(wèn)以下接口。在下面的示例中 統(tǒng)一用 getXXX()表示獲取子類實(shí)例的方法。

具體使用時(shí),請(qǐng)根據(jù)實(shí)際采用的Nfc tag技術(shù)，選擇對(duì)應(yīng)的方法，具體請(qǐng)參見nfcTag文檔。

tagSession.getTagInfo

getTagInfo(): tag.TagInfo

獲取該Tag被分發(fā)時(shí)，NFC服務(wù)所提供的Tag數(shù)據(jù)對(duì)象。

需要權(quán)限： ohos.permission.NFC_TAG

系統(tǒng)能力： SystemCapability.Communication.NFC.Tag

返回值：

示例：

import tag from '@ohos.nfc.tag';

// see 'tag.TagInfo' at 'js-apis-nfcTag.md', tagInfo is an Object given by nfc service when tag is dispatched.
// the folowing getXXX, can be one of getIsoDep, getNdef, getMifareClassic, ...

let tagInfo = tag.getIsoDep(tagInfo).getTagInfo(); 
console.log("tag tagInfo: " + tagInfo);

tagSession.connectTag

connectTag(): boolean;

和標(biāo)簽建立連接。在從標(biāo)簽讀取數(shù)據(jù)或?qū)?shù)據(jù)寫入標(biāo)簽之前，必須調(diào)用此方法。

需要權(quán)限： ohos.permission.NFC_TAG

系統(tǒng)能力： SystemCapability.Communication.NFC.Tag

返回值：

示例：

import tag from '@ohos.nfc.tag';

// see 'tag.TagInfo' at 'js-apis-nfcTag.md', tagInfo is an Object given by nfc service when tag is dispatched.
// the folowing getXXX, can be one of getIsoDep, getNdef, getMifareClassic, ...

let connectStatus = tag.getIsoDep(tagInfo).connectTag(); 
console.log("connectStatus: " + connectStatus);

tagSession.connect9+

connect(): void;

和標(biāo)簽建立連接。在從標(biāo)簽讀取數(shù)據(jù)或?qū)?shù)據(jù)寫入標(biāo)簽之前，必須調(diào)用此方法。

需要權(quán)限： ohos.permission.NFC_TAG

系統(tǒng)能力： SystemCapability.Communication.NFC.Tag

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見NFC錯(cuò)誤碼。

示例：

import tag from '@ohos.nfc.tag';

// see 'tag.TagInfo' at 'js-apis-nfcTag.md', tagInfo is an Object given by nfc service when tag is dispatched.
// the folowing getXXX, can be one of getIsoDep, getNdef, getMifareClassic, ...

try {
    tag.getIsoDep(tagInfo).connect(); 
    console.log("tag connect success");
} catch (busiError) {
    console.log("tag connect busiError: " + busiError);
}

tagSession.reset()

reset(): void

重置與標(biāo)簽的連接。

需要權(quán)限： ohos.permission.NFC_TAG

系統(tǒng)能力： SystemCapability.Communication.NFC.Tag

示例：

import tag from '@ohos.nfc.tag';

// see 'tag.TagInfo' at 'js-apis-nfcTag.md', tagInfo is an Object given by nfc service when tag is dispatched.
// the folowing getXXX, can be one of getIsoDep, getNdef, getMifareClassic, ...

tag.getIsoDep(tagInfo).reset(); 

tagSession.resetConnection()9+

resetConnection(): void

重置與標(biāo)簽的連接。

需要權(quán)限： ohos.permission.NFC_TAG

系統(tǒng)能力： SystemCapability.Communication.NFC.Tag

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見NFC錯(cuò)誤碼。

示例：

import tag from '@ohos.nfc.tag';

// see 'tag.TagInfo' at 'js-apis-nfcTag.md', tagInfo is an Object given by nfc service when tag is dispatched.
// the folowing getXXX, can be one of getIsoDep, getNdef, getMifareClassic, ...

try {
    tag.getIsoDep(tagInfo).resetConnection(); 
    console.log("tag resetConnection success");
} catch (busiError) {
    console.log("tag resetConnection busiError: " + busiError);
}

tagSession.isTagConnected

isTagConnected(): boolean

檢查是否已與標(biāo)簽建立連接。

需要權(quán)限： ohos.permission.NFC_TAG

系統(tǒng)能力： SystemCapability.Communication.NFC.Tag

返回值：

示例：

import tag from '@ohos.nfc.tag';

// see 'tag.TagInfo' at 'js-apis-nfcTag.md', tagInfo is an Object given by nfc service when tag is dispatched.
// the folowing getXXX, can be one of getIsoDep, getNdef, getMifareClassic, ...

let isTagConnected = tag.getIsoDep(tagInfo).isTagConnected(); 
console.log("isTagConnected: " + isTagConnected);

tagSession.isConnected9+

isConnected(): boolean

檢查是否已與標(biāo)簽建立連接。

需要權(quán)限： ohos.permission.NFC_TAG

系統(tǒng)能力： SystemCapability.Communication.NFC.Tag

返回值：

示例：

import tag from '@ohos.nfc.tag';

// see 'tag.TagInfo' at 'js-apis-nfcTag.md', tagInfo is an Object given by nfc service when tag is dispatched.
// the folowing getXXX, can be one of getIsoDep, getNdef, getMifareClassic, ...

try {
    var isConnected = tag.getIsoDep(tagInfo).isConnected(); 
    console.log("tag isConnected = " + isConnected);
} catch (busiError) {
    console.log("tag isConnected busiError: " + busiError);
}

tagSession.getMaxSendLength

getMaxSendLength(): number

查詢可以發(fā)送到標(biāo)簽的最大數(shù)據(jù)長(zhǎng)度。

需要權(quán)限： ohos.permission.NFC_TAG

系統(tǒng)能力： SystemCapability.Communication.NFC.Tag

返回值：

示例：

import tag from '@ohos.nfc.tag';

// see 'tag.TagInfo' at 'js-apis-nfcTag.md', tagInfo is an Object given by nfc service when tag is dispatched.
// the folowing getXXX, can be one of getIsoDep, getNdef, getMifareClassic, ...

let maxSendLen = tag.getIsoDep(tagInfo).getMaxSendLength(); 
console.log("tag maxSendLen: " + maxSendLen);

tagSession.getMaxTransmitSize9+

getMaxTransmitSize(): number

查詢可以發(fā)送到標(biāo)簽的最大數(shù)據(jù)長(zhǎng)度。

需要權(quán)限： ohos.permission.NFC_TAG

系統(tǒng)能力： SystemCapability.Communication.NFC.Tag

返回值：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見NFC錯(cuò)誤碼。

示例：

import tag from '@ohos.nfc.tag';

// see 'tag.TagInfo' at 'js-apis-nfcTag.md', tagInfo is an Object given by nfc service when tag is dispatched.
// the folowing getXXX, can be one of getIsoDep, getNdef, getMifareClassic, ...

try {
    var maxTransmitSize = tag.getIsoDep(tagInfo).getMaxTransmitSize(); 
    console.log("tag maxTransmitSize = " + maxTransmitSize);
} catch (busiError) {
    console.log("tag getMaxTransmitSize busiError: " + busiError);
}

tagSession.getSendDataTimeout

getSendDataTimeout(): number

查詢發(fā)送數(shù)據(jù)到Tag的等待超時(shí)時(shí)間，單位是毫秒。

需要權(quán)限： ohos.permission.NFC_TAG

系統(tǒng)能力： SystemCapability.Communication.NFC.Tag

返回值：

示例：

import tag from '@ohos.nfc.tag';

// see 'tag.TagInfo' at 'js-apis-nfcTag.md', tagInfo is an Object given by nfc service when tag is dispatched.
// the folowing getXXX, can be one of getIsoDep, getNdef, getMifareClassic, ...

let sendDataTimeout = tag.getIsoDep(tagInfo).getSendDataTimeout(); 
console.log("tag sendDataTimeout: " + sendDataTimeout);

tagSession.getTimeout9+

getTimeout(): number

查詢發(fā)送數(shù)據(jù)到Tag的等待超時(shí)時(shí)間，單位是毫秒。

需要權(quán)限： ohos.permission.NFC_TAG

系統(tǒng)能力： SystemCapability.Communication.NFC.Tag

返回值：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見NFC錯(cuò)誤碼。

示例：

import tag from '@ohos.nfc.tag';

// see 'tag.TagInfo' at 'js-apis-nfcTag.md', tagInfo is an Object given by nfc service when tag is dispatched.
// the folowing getXXX, can be one of getIsoDep, getNdef, getMifareClassic, ...

try {
    var timeout = tag.getIsoDep(tagInfo).getTimeout(); 
    console.log("tag timeout = " + timeout);
} catch (busiError) {
    console.log("tag getTimeout busiError: " + busiError);
}

tagSession.setSendDataTimeout

setSendDataTimeout(timeout: number): boolean

查詢發(fā)送數(shù)據(jù)到Tag的等待超時(shí)時(shí)間，單位是毫秒。

需要權(quán)限： ohos.permission.NFC_TAG

系統(tǒng)能力： SystemCapability.Communication.NFC.Tag

參數(shù)：

返回值：

示例：

import tag from '@ohos.nfc.tag';

// see 'tag.TagInfo' at 'js-apis-nfcTag.md', tagInfo is an Object given by nfc service when tag is dispatched.
// the folowing getXXX, can be one of getIsoDep, getNdef, getMifareClassic, ...

let timeoutMs = 700;  // change it to be correct.
let setStatus = tag.getIsoDep(tagInfo).setSendDataTimeout(timeoutMs); 
console.log("tag setSendDataTimeout setStatus: " + setStatus);

tagSession.setTimeout9+

setTimeout(timeout: number): void

查詢發(fā)送數(shù)據(jù)到Tag的等待超時(shí)時(shí)間，單位是毫秒。

需要權(quán)限： ohos.permission.NFC_TAG

系統(tǒng)能力： SystemCapability.Communication.NFC.Tag

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見NFC錯(cuò)誤碼。

示例：

import tag from '@ohos.nfc.tag';

// see 'tag.TagInfo' at 'js-apis-nfcTag.md', tagInfo is an Object given by nfc service when tag is dispatched.
// the folowing getXXX, can be one of getIsoDep, getNdef, getMifareClassic, ...

let timeoutMs = 700;  // change it to be correct.
try {
    tag.getIsoDep(tagInfo).setTimeout(timeoutMs); 
    console.log("tag setTimeout success");
} catch (busiError) {
    console.log("tag setTimeout busiError: " + busiError);
}

tagSession.sendData

sendData(data: number[]): Promise<number[]>

發(fā)送指令到Tag上，使用Promise方式作為異步方法。

需要權(quán)限： ohos.permission.NFC_TAG

系統(tǒng)能力： SystemCapability.Communication.NFC.Tag

參數(shù)：

返回值：

示例：

import tag from '@ohos.nfc.tag';

// see 'tag.TagInfo' at 'js-apis-nfcTag.md', tagInfo is an Object given by nfc service when tag is dispatched.
// the folowing getXXX, can be one of getIsoDep, getNdef, getMifareClassic, ...

// connect the tag at first if not connected.
if (!tag.getIsoDep(tagInfo).isTagConnected()) {
    if (!tag.getIsoDep(tagInfo).connectTag()) {
        console.log("tagSession connectTag failed.");
        return;
    }
}

let cmdData = [0x01, 0x02, 0x03, 0x04]; // change the raw data to be correct.
tag.getIsoDep(tagInfo).sendData(cmdData).then((response) => {
    console.log("tagSession sendData Promise response: " + response);
}).catch((err)=> {
    console.log("tagSession sendData Promise err: " + err);
});

tagSession.sendData

sendData(data: number[], callback: AsyncCallback<number[]>): void

發(fā)送指令到Tag上，使用AsyncCallback方式作為異步方法。

需要權(quán)限： ohos.permission.NFC_TAG

系統(tǒng)能力： SystemCapability.Communication.NFC.Tag

參數(shù)：

示例：

import tag from '@ohos.nfc.tag';

// see 'tag.TagInfo' at 'js-apis-nfcTag.md', tagInfo is an Object given by nfc service when tag is dispatched.
// the folowing getXXX, can be one of getIsoDep, getNdef, getMifareClassic, ...

// connect the tag at first if not connected.
if (!tag.getIsoDep(tagInfo).isTagConnected()) {
    if (!tag.getIsoDep(tagInfo).connectTag()) {
        console.log("tagSession connectTag failed.");
        return;
    }
}

let cmdData = [0x01, 0x02, 0x03, 0x04]; // change the raw data to be correct.
tag.getIsoDep(tagInfo).sendData(cmdData, (err, response)=> {
    if (err) {
        console.log("tagSession sendData AsyncCallback err: " + err);
    } else {
        console.log("tagSession sendData AsyncCallback response: " + response);
    }
});

tagSession.transmit9+

transmit(data: number[]): Promise<number[]>

發(fā)送指令到Tag上，使用Promise方式作為異步方法。

需要權(quán)限： ohos.permission.NFC_TAG

系統(tǒng)能力： SystemCapability.Communication.NFC.Tag

參數(shù)：

返回值：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見NFC錯(cuò)誤碼。

示例：

import tag from '@ohos.nfc.tag';

// see 'tag.TagInfo' at 'js-apis-nfcTag.md', tagInfo is an Object given by nfc service when tag is dispatched.
// the folowing getXXX, can be one of getIsoDep, getNdef, getMifareClassic, ...

// connect the tag at first if not connected.
try {
    if (!tag.getIsoDep(tagInfo).isConnected()) {
        tag.getIsoDep(tagInfo).connect();
    }
} catch (busiError) {
    console.log("tag connect busiError: " + busiError);
    return;
}

let cmdData = [0x01, 0x02, 0x03, 0x04]; // change the raw data to be correct.
try {
    tag.getIsoDep(tagInfo).transmit(cmdData).then((response) => {
        console.log("tagSession transmit Promise response: " + response);
    }).catch((err)=> {
        console.log("tagSession transmit Promise err: " + err);
    });
} catch (busiError) {
    console.log("tag transmit busiError: " + busiError);
    return;
}

tagSession.transmit9+

transmit(data: number[], callback: AsyncCallback<number[]>): void

發(fā)送指令到Tag上，使用AsyncCallback方式作為異步方法。

需要權(quán)限： ohos.permission.NFC_TAG

系統(tǒng)能力： SystemCapability.Communication.NFC.Tag

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見NFC錯(cuò)誤碼。

示例：

import tag from '@ohos.nfc.tag';

// see 'tag.TagInfo' at 'js-apis-nfcTag.md', tagInfo is an Object given by nfc service when tag is dispatched.
// the folowing getXXX, can be one of getIsoDep, getNdef, getMifareClassic, ...

// connect the tag at first if not connected.
try {
    if (!tag.getIsoDep(tagInfo).isConnected()) {
        tag.getIsoDep(tagInfo).connect();
    }
} catch (busiError) {
    console.log("tag connect busiError: " + busiError);
    return;
}

let cmdData = [0x01, 0x02, 0x03, 0x04]; // change the raw data to be correct.
try {
    tag.getIsoDep(tagInfo).transmit(cmdData, (err, response)=> {
        if (err) {
            console.log("tagSession transmit AsyncCallback err: " + err);
        } else {
            console.log("tagSession transmit AsyncCallback response: " + response);
        }
    });
} catch (busiError) {
    console.log("tag transmit busiError: " + busiError);
    return;
}