W3Cschool
恭喜您成為首批注冊(cè)用戶
獲得88經(jīng)驗(yàn)值獎(jiǎng)勵(lì)
本模塊提供有源標(biāo)簽的使用,包括初始化有源標(biāo)簽芯片、讀取有源標(biāo)簽內(nèi)容、寫入內(nèi)容到有源標(biāo)簽等。
本模塊首批接口從API version 8開始支持。后續(xù)版本的新增接口,采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。
init(): boolean
初始化有源標(biāo)簽芯片。
需要權(quán)限:ohos.permission.NFC_TAG
系統(tǒng)能力:SystemCapability.Communication.ConnectedTag
返回值:
類型 | 說明 |
---|---|
boolean | true:初始化成功, false:初始化失敗。 |
uninit(): boolean
卸載有源標(biāo)簽芯片資源。
需要權(quán)限:ohos.permission.NFC_TAG
系統(tǒng)能力:SystemCapability.Communication.ConnectedTag
返回值:
類型 | 說明 |
---|---|
boolean | true:卸載操作成功, false:卸載操作失敗。 |
readNdefTag(): Promise<string>
讀取有源標(biāo)簽內(nèi)容,使用promise方式作為異步方法。
需要權(quán)限:ohos.permission.NFC_TAG
系統(tǒng)能力:SystemCapability.Communication.ConnectedTag
返回值:
類型 | 說明 |
---|---|
Promise<string> | 返回讀取有源標(biāo)簽內(nèi)容。 |
示例:
- import connectedTag from '@ohos.connectedTag';
- connectedTag.readNdefTag().then((data) => {
- console.log("connectedTag readNdefTag Promise data = " + data);
- }).catch((err)=> {
- console.log("connectedTag readNdefTag Promise err: " + err);
- });
readNdefTag(callback: AsyncCallback<string>): void
讀取有源標(biāo)簽內(nèi)容,使用AsyncCallback方式作為異步方法。
需要權(quán)限:ohos.permission.NFC_TAG
系統(tǒng)能力:SystemCapability.Communication.ConnectedTag
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
callback | AsyncCallback<string> | 是 | 讀取有源標(biāo)簽內(nèi)容回調(diào)函數(shù)。 |
示例:
- import connectedTag from '@ohos.connectedTag';
- connectedTag.readNdefTag((err, data)=> {
- if (err) {
- console.log("connectedTag readNdefTag AsyncCallback err: " + err);
- } else {
- console.log("connectedTag readNdefTag AsyncCallback data: " + data);
- }
- });
writeNdefTag(data: string): Promise<void>
寫入內(nèi)容到有源標(biāo)簽,使用promise方式作為異步方法。
需要權(quán)限:ohos.permission.NFC_TAG
系統(tǒng)能力:SystemCapability.Communication.ConnectedTag
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
data | string | 是 | 有源標(biāo)簽內(nèi)容, 長(zhǎng)度最大是1024個(gè)字節(jié)。 |
返回值:
類型 | 說明 |
---|---|
Promise<void> | 無返回值。 |
示例:
- import connectedTag from '@ohos.connectedTag';
- var rawData = "010203"; // change it tobe correct.
- connectedTag.writeNdefTag(rawData).then(() => {
- console.log("connectedTag writeNdefTag Promise success.");
- }).catch((err)=> {
- console.log("connectedTag writeNdefTag Promise err: " + err);
- });
writeNdefTag(data: string, callback: AsyncCallback<void>): void
寫入內(nèi)容到有源標(biāo)簽,使用AsyncCallback方式作為異步方法。
需要權(quán)限:ohos.permission.NFC_TAG
系統(tǒng)能力:SystemCapability.Communication.ConnectedTag
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
data | string | 是 | 有源標(biāo)簽內(nèi)容, 長(zhǎng)度最大是1024個(gè)字節(jié)。 |
callback | AsyncCallback<void> | 是 | 讀取有源標(biāo)簽內(nèi)容回調(diào)函數(shù)。 |
示例:
- import connectedTag from '@ohos.connectedTag';
- var rawData = "010203"; // change it tobe correct.
- connectedTag.writeNdefTag(rawData, (err)=> {
- if (err) {
- console.log("connectedTag writeNdefTag AsyncCallback err: " + err);
- } else {
- console.log("connectedTag writeNdefTag AsyncCallback success.");
- }
- });
on(type: "notify", callback: Callback<number>): void
注冊(cè)NFC場(chǎng)強(qiáng)狀態(tài)事件。
需要權(quán)限:ohos.permission.NFC_TAG
系統(tǒng)能力:SystemCapability.Communication.ConnectedTag
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
type | string | 是 | 固定填"notify"字符串 |
callback | Callback<number> | 是 | 狀態(tài)改變回調(diào)函數(shù),返回值參見NfcRfType。 |
off(type: "notify", callback?: Callback<number>): void
取消NFC場(chǎng)強(qiáng)狀態(tài)事件的注冊(cè)。
需要權(quán)限:ohos.permission.NFC_TAG
系統(tǒng)能力:SystemCapability.Communication.ConnectedTag
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
type | string | 是 | 固定填"notify"字符串 |
callback | Callback<number> | 否 | 狀態(tài)改變回調(diào)函數(shù)。如果callback不填,將“去注冊(cè)”該事件關(guān)聯(lián)的所有回調(diào)函數(shù)。 |
示例:
- import connectedTag from '@ohos.connectedTag';
- // Register event
- connectedTag.on("notify", (err, rfState)=> {
- if (err) {
- console.log("connectedTag on Callback err: " + err);
- } else {
- console.log("connectedTag on Callback rfState: " + rfState);
- }
- });
- var initStatus = connectedTag.init();
- console.log("connectedTag init status: " + initStatus);
- // Add nfc connecected tag business oprations here...
- // connectedTag.writeNdefTag(rawData)
- // connectedTag.readNdefTag()
- var uninitStatus = connectedTag.uninit();
- console.log("connectedTag uninit status: " + uninitStatus);
- // Unregister event
- connectedTag.off("notify", (err, rfState)=> {
- if (err) {
- console.log("connectedTag off Callback err: " + err);
- } else {
- console.log("connectedTag off Callback rfState: " + rfState);
- }
- });
Copyright©2021 w3cschool編程獅|閩ICP備15016281號(hào)-3|閩公網(wǎng)安備35020302033924號(hào)
違法和不良信息舉報(bào)電話:173-0602-2364|舉報(bào)郵箱:jubao@eeedong.com
掃描二維碼
下載編程獅App
編程獅公眾號(hào)
聯(lián)系方式:
更多建議: