161847f8eSopenharmony_ci/* 261847f8eSopenharmony_ci * Copyright (c) 2021-2022 Huawei Device Co., Ltd. 361847f8eSopenharmony_ci * Licensed under the Apache License, Version 2.0 (the "License"); 461847f8eSopenharmony_ci * you may not use this file except in compliance with the License. 561847f8eSopenharmony_ci * You may obtain a copy of the License at 661847f8eSopenharmony_ci * 761847f8eSopenharmony_ci * http://www.apache.org/licenses/LICENSE-2.0 861847f8eSopenharmony_ci * 961847f8eSopenharmony_ci * Unless required by applicable law or agreed to in writing, software 1061847f8eSopenharmony_ci * distributed under the License is distributed on an "AS IS" BASIS, 1161847f8eSopenharmony_ci * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 1261847f8eSopenharmony_ci * See the License for the specific language governing permissions and 1361847f8eSopenharmony_ci * limitations under the License. 1461847f8eSopenharmony_ci */ 1561847f8eSopenharmony_ci 1661847f8eSopenharmony_ci/** 1761847f8eSopenharmony_ci * @file 1861847f8eSopenharmony_ci * @kit ConnectivityKit 1961847f8eSopenharmony_ci */ 2061847f8eSopenharmony_ci 2161847f8eSopenharmony_ciimport type { NfcATag as _NfcATag, NfcBTag as _NfcBTag, NfcFTag as _NfcFTag, NfcVTag as _NfcVTag } from './tag/nfctech'; 2261847f8eSopenharmony_ciimport { 2361847f8eSopenharmony_ci IsoDepTag as _IsoDepTag, 2461847f8eSopenharmony_ci NdefTag as _NdefTag, 2561847f8eSopenharmony_ci MifareClassicTag as _MifareClassicTag, 2661847f8eSopenharmony_ci MifareUltralightTag as _MifareUltralightTag, 2761847f8eSopenharmony_ci NdefFormatableTag as _NdefFormatableTag 2861847f8eSopenharmony_ci} from './tag/nfctech'; 2961847f8eSopenharmony_ciimport { NdefMessage as _NdefMessage } from './tag/nfctech'; 3061847f8eSopenharmony_ciimport { TagSession as _TagSession } from './tag/tagSession'; 3161847f8eSopenharmony_ciimport type { PacMap } from './ability/dataAbilityHelper'; 3261847f8eSopenharmony_ciimport type rpc from './@ohos.rpc'; 3361847f8eSopenharmony_ciimport type { AsyncCallback } from './@ohos.base'; 3461847f8eSopenharmony_ciimport Want from './@ohos.app.ability.Want'; 3561847f8eSopenharmony_ciimport type { ElementName } from './bundleManager/ElementName'; 3661847f8eSopenharmony_ci 3761847f8eSopenharmony_ci/** 3861847f8eSopenharmony_ci * Provides methods to operate or manage NFC tag. 3961847f8eSopenharmony_ci * 4061847f8eSopenharmony_ci * @namespace tag 4161847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 4261847f8eSopenharmony_ci * @since 7 4361847f8eSopenharmony_ci */ 4461847f8eSopenharmony_ci/** 4561847f8eSopenharmony_ci * Provides methods to operate or manage NFC tag. 4661847f8eSopenharmony_ci * 4761847f8eSopenharmony_ci * @namespace tag 4861847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 4961847f8eSopenharmony_ci * @atomicservice 5061847f8eSopenharmony_ci * @since 12 5161847f8eSopenharmony_ci */ 5261847f8eSopenharmony_cideclare namespace tag { 5361847f8eSopenharmony_ci /** 5461847f8eSopenharmony_ci * Indicates an NFC-A tag. 5561847f8eSopenharmony_ci * 5661847f8eSopenharmony_ci * @constant 5761847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 5861847f8eSopenharmony_ci * @since 7 5961847f8eSopenharmony_ci */ 6061847f8eSopenharmony_ci /** 6161847f8eSopenharmony_ci * Indicates an NFC-A tag. 6261847f8eSopenharmony_ci * 6361847f8eSopenharmony_ci * @constant 6461847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 6561847f8eSopenharmony_ci * @atomicservice 6661847f8eSopenharmony_ci * @since 12 6761847f8eSopenharmony_ci */ 6861847f8eSopenharmony_ci const NFC_A = 1; 6961847f8eSopenharmony_ci 7061847f8eSopenharmony_ci /** 7161847f8eSopenharmony_ci * Indicates an NFC-B tag. 7261847f8eSopenharmony_ci * 7361847f8eSopenharmony_ci * @constant 7461847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 7561847f8eSopenharmony_ci * @since 7 7661847f8eSopenharmony_ci */ 7761847f8eSopenharmony_ci /** 7861847f8eSopenharmony_ci * Indicates an NFC-B tag. 7961847f8eSopenharmony_ci * 8061847f8eSopenharmony_ci * @constant 8161847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 8261847f8eSopenharmony_ci * @atomicservice 8361847f8eSopenharmony_ci * @since 12 8461847f8eSopenharmony_ci */ 8561847f8eSopenharmony_ci const NFC_B = 2; 8661847f8eSopenharmony_ci 8761847f8eSopenharmony_ci /** 8861847f8eSopenharmony_ci * Indicates an ISO_DEP tag. 8961847f8eSopenharmony_ci * 9061847f8eSopenharmony_ci * @constant 9161847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 9261847f8eSopenharmony_ci * @since 7 9361847f8eSopenharmony_ci */ 9461847f8eSopenharmony_ci /** 9561847f8eSopenharmony_ci * Indicates an ISO_DEP tag. 9661847f8eSopenharmony_ci * 9761847f8eSopenharmony_ci * @constant 9861847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 9961847f8eSopenharmony_ci * @atomicservice 10061847f8eSopenharmony_ci * @since 12 10161847f8eSopenharmony_ci */ 10261847f8eSopenharmony_ci const ISO_DEP = 3; 10361847f8eSopenharmony_ci 10461847f8eSopenharmony_ci /** 10561847f8eSopenharmony_ci * Indicates an NFC-F tag. 10661847f8eSopenharmony_ci * 10761847f8eSopenharmony_ci * @constant 10861847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 10961847f8eSopenharmony_ci * @since 7 11061847f8eSopenharmony_ci */ 11161847f8eSopenharmony_ci /** 11261847f8eSopenharmony_ci * Indicates an NFC-F tag. 11361847f8eSopenharmony_ci * 11461847f8eSopenharmony_ci * @constant 11561847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 11661847f8eSopenharmony_ci * @atomicservice 11761847f8eSopenharmony_ci * @since 12 11861847f8eSopenharmony_ci */ 11961847f8eSopenharmony_ci const NFC_F = 4; 12061847f8eSopenharmony_ci 12161847f8eSopenharmony_ci /** 12261847f8eSopenharmony_ci * Indicates an NFC-V tag. 12361847f8eSopenharmony_ci * 12461847f8eSopenharmony_ci * @constant 12561847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 12661847f8eSopenharmony_ci * @since 7 12761847f8eSopenharmony_ci */ 12861847f8eSopenharmony_ci /** 12961847f8eSopenharmony_ci * Indicates an NFC-V tag. 13061847f8eSopenharmony_ci * 13161847f8eSopenharmony_ci * @constant 13261847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 13361847f8eSopenharmony_ci * @atomicservice 13461847f8eSopenharmony_ci * @since 12 13561847f8eSopenharmony_ci */ 13661847f8eSopenharmony_ci const NFC_V = 5; 13761847f8eSopenharmony_ci 13861847f8eSopenharmony_ci /** 13961847f8eSopenharmony_ci * Indicates an NDEF tag. 14061847f8eSopenharmony_ci * 14161847f8eSopenharmony_ci * @constant 14261847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 14361847f8eSopenharmony_ci * @since 7 14461847f8eSopenharmony_ci */ 14561847f8eSopenharmony_ci /** 14661847f8eSopenharmony_ci * Indicates an NDEF tag. 14761847f8eSopenharmony_ci * 14861847f8eSopenharmony_ci * @constant 14961847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 15061847f8eSopenharmony_ci * @atomicservice 15161847f8eSopenharmony_ci * @since 12 15261847f8eSopenharmony_ci */ 15361847f8eSopenharmony_ci const NDEF = 6; 15461847f8eSopenharmony_ci 15561847f8eSopenharmony_ci /** 15661847f8eSopenharmony_ci * Indicates an NDEF Formatable tag. 15761847f8eSopenharmony_ci * 15861847f8eSopenharmony_ci * @constant 15961847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 16061847f8eSopenharmony_ci * @since 9 16161847f8eSopenharmony_ci */ 16261847f8eSopenharmony_ci /** 16361847f8eSopenharmony_ci * Indicates an NDEF Formatable tag. 16461847f8eSopenharmony_ci * 16561847f8eSopenharmony_ci * @constant 16661847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 16761847f8eSopenharmony_ci * @atomicservice 16861847f8eSopenharmony_ci * @since 12 16961847f8eSopenharmony_ci */ 17061847f8eSopenharmony_ci const NDEF_FORMATABLE = 7; 17161847f8eSopenharmony_ci 17261847f8eSopenharmony_ci /** 17361847f8eSopenharmony_ci * Indicates an MIFARE CLASSIC tag. 17461847f8eSopenharmony_ci * 17561847f8eSopenharmony_ci * @constant 17661847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 17761847f8eSopenharmony_ci * @since 7 17861847f8eSopenharmony_ci */ 17961847f8eSopenharmony_ci /** 18061847f8eSopenharmony_ci * Indicates an MIFARE CLASSIC tag. 18161847f8eSopenharmony_ci * 18261847f8eSopenharmony_ci * @constant 18361847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 18461847f8eSopenharmony_ci * @atomicservice 18561847f8eSopenharmony_ci * @since 12 18661847f8eSopenharmony_ci */ 18761847f8eSopenharmony_ci const MIFARE_CLASSIC = 8; 18861847f8eSopenharmony_ci 18961847f8eSopenharmony_ci /** 19061847f8eSopenharmony_ci * Indicates an MIFARE ULTRALIGHT tag. 19161847f8eSopenharmony_ci * 19261847f8eSopenharmony_ci * @constant 19361847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 19461847f8eSopenharmony_ci * @since 7 19561847f8eSopenharmony_ci */ 19661847f8eSopenharmony_ci /** 19761847f8eSopenharmony_ci * Indicates an MIFARE ULTRALIGHT tag. 19861847f8eSopenharmony_ci * 19961847f8eSopenharmony_ci * @constant 20061847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 20161847f8eSopenharmony_ci * @atomicservice 20261847f8eSopenharmony_ci * @since 12 20361847f8eSopenharmony_ci */ 20461847f8eSopenharmony_ci const MIFARE_ULTRALIGHT = 9; 20561847f8eSopenharmony_ci 20661847f8eSopenharmony_ci /** 20761847f8eSopenharmony_ci * TNF types definitions, see NFCForum-TS-NDEF_1.0. 20861847f8eSopenharmony_ci * 20961847f8eSopenharmony_ci * @enum { number } 21061847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 21161847f8eSopenharmony_ci * @since 9 21261847f8eSopenharmony_ci */ 21361847f8eSopenharmony_ci /** 21461847f8eSopenharmony_ci * TNF types definitions, see NFCForum-TS-NDEF_1.0. 21561847f8eSopenharmony_ci * 21661847f8eSopenharmony_ci * @enum { number } 21761847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 21861847f8eSopenharmony_ci * @atomicservice 21961847f8eSopenharmony_ci * @since 12 22061847f8eSopenharmony_ci */ 22161847f8eSopenharmony_ci enum TnfType { 22261847f8eSopenharmony_ci /** 22361847f8eSopenharmony_ci * Empty 22461847f8eSopenharmony_ci * 22561847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 22661847f8eSopenharmony_ci * @since 9 22761847f8eSopenharmony_ci */ 22861847f8eSopenharmony_ci /** 22961847f8eSopenharmony_ci * Empty 23061847f8eSopenharmony_ci * 23161847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 23261847f8eSopenharmony_ci * @atomicservice 23361847f8eSopenharmony_ci * @since 12 23461847f8eSopenharmony_ci */ 23561847f8eSopenharmony_ci TNF_EMPTY = 0x0, 23661847f8eSopenharmony_ci 23761847f8eSopenharmony_ci /** 23861847f8eSopenharmony_ci * NFC Forum well-known type [NFC RTD] 23961847f8eSopenharmony_ci * 24061847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 24161847f8eSopenharmony_ci * @since 9 24261847f8eSopenharmony_ci */ 24361847f8eSopenharmony_ci /** 24461847f8eSopenharmony_ci * NFC Forum well-known type [NFC RTD] 24561847f8eSopenharmony_ci * 24661847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 24761847f8eSopenharmony_ci * @atomicservice 24861847f8eSopenharmony_ci * @since 12 24961847f8eSopenharmony_ci */ 25061847f8eSopenharmony_ci TNF_WELL_KNOWN = 0x1, 25161847f8eSopenharmony_ci 25261847f8eSopenharmony_ci /** 25361847f8eSopenharmony_ci * Media-type as defined in RFC 2046 [RFC 2046] 25461847f8eSopenharmony_ci * 25561847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 25661847f8eSopenharmony_ci * @since 9 25761847f8eSopenharmony_ci */ 25861847f8eSopenharmony_ci /** 25961847f8eSopenharmony_ci * Media-type as defined in RFC 2046 [RFC 2046] 26061847f8eSopenharmony_ci * 26161847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 26261847f8eSopenharmony_ci * @atomicservice 26361847f8eSopenharmony_ci * @since 12 26461847f8eSopenharmony_ci */ 26561847f8eSopenharmony_ci TNF_MEDIA = 0x2, 26661847f8eSopenharmony_ci 26761847f8eSopenharmony_ci /** 26861847f8eSopenharmony_ci * Absolute URI as defined in RFC 3986 [RFC 3986] 26961847f8eSopenharmony_ci * 27061847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 27161847f8eSopenharmony_ci * @since 9 27261847f8eSopenharmony_ci */ 27361847f8eSopenharmony_ci /** 27461847f8eSopenharmony_ci * Absolute URI as defined in RFC 3986 [RFC 3986] 27561847f8eSopenharmony_ci * 27661847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 27761847f8eSopenharmony_ci * @atomicservice 27861847f8eSopenharmony_ci * @since 12 27961847f8eSopenharmony_ci */ 28061847f8eSopenharmony_ci TNF_ABSOLUTE_URI = 0x3, 28161847f8eSopenharmony_ci 28261847f8eSopenharmony_ci /** 28361847f8eSopenharmony_ci * NFC Forum external type [NFC RTD] 28461847f8eSopenharmony_ci * 28561847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 28661847f8eSopenharmony_ci * @since 9 28761847f8eSopenharmony_ci */ 28861847f8eSopenharmony_ci /** 28961847f8eSopenharmony_ci * NFC Forum external type [NFC RTD] 29061847f8eSopenharmony_ci * 29161847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 29261847f8eSopenharmony_ci * @atomicservice 29361847f8eSopenharmony_ci * @since 12 29461847f8eSopenharmony_ci */ 29561847f8eSopenharmony_ci TNF_EXT_APP = 0x4, 29661847f8eSopenharmony_ci 29761847f8eSopenharmony_ci /** 29861847f8eSopenharmony_ci * Unknown 29961847f8eSopenharmony_ci * 30061847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 30161847f8eSopenharmony_ci * @since 9 30261847f8eSopenharmony_ci */ 30361847f8eSopenharmony_ci /** 30461847f8eSopenharmony_ci * Unknown 30561847f8eSopenharmony_ci * 30661847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 30761847f8eSopenharmony_ci * @atomicservice 30861847f8eSopenharmony_ci * @since 12 30961847f8eSopenharmony_ci */ 31061847f8eSopenharmony_ci TNF_UNKNOWN = 0x5, 31161847f8eSopenharmony_ci 31261847f8eSopenharmony_ci /** 31361847f8eSopenharmony_ci * Unchanged (see section 2.3.3) 31461847f8eSopenharmony_ci * 31561847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 31661847f8eSopenharmony_ci * @since 9 31761847f8eSopenharmony_ci */ 31861847f8eSopenharmony_ci /** 31961847f8eSopenharmony_ci * Unchanged (see section 2.3.3) 32061847f8eSopenharmony_ci * 32161847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 32261847f8eSopenharmony_ci * @atomicservice 32361847f8eSopenharmony_ci * @since 12 32461847f8eSopenharmony_ci */ 32561847f8eSopenharmony_ci TNF_UNCHANGED = 0x6 32661847f8eSopenharmony_ci } 32761847f8eSopenharmony_ci 32861847f8eSopenharmony_ci /** 32961847f8eSopenharmony_ci * NfcForum Type definition. The NDEF tag may use one of them. 33061847f8eSopenharmony_ci * 33161847f8eSopenharmony_ci * @enum { number } 33261847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 33361847f8eSopenharmony_ci * @since 9 33461847f8eSopenharmony_ci */ 33561847f8eSopenharmony_ci /** 33661847f8eSopenharmony_ci * NfcForum Type definition. The NDEF tag may use one of them. 33761847f8eSopenharmony_ci * 33861847f8eSopenharmony_ci * @enum { number } 33961847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 34061847f8eSopenharmony_ci * @atomicservice 34161847f8eSopenharmony_ci * @since 12 34261847f8eSopenharmony_ci */ 34361847f8eSopenharmony_ci enum NfcForumType { 34461847f8eSopenharmony_ci /** 34561847f8eSopenharmony_ci * NFC FORUM TYPE 1 34661847f8eSopenharmony_ci * 34761847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 34861847f8eSopenharmony_ci * @since 9 34961847f8eSopenharmony_ci */ 35061847f8eSopenharmony_ci /** 35161847f8eSopenharmony_ci * NFC FORUM TYPE 1 35261847f8eSopenharmony_ci * 35361847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 35461847f8eSopenharmony_ci * @atomicservice 35561847f8eSopenharmony_ci * @since 12 35661847f8eSopenharmony_ci */ 35761847f8eSopenharmony_ci NFC_FORUM_TYPE_1 = 1, 35861847f8eSopenharmony_ci 35961847f8eSopenharmony_ci /** 36061847f8eSopenharmony_ci * NFC FORUM TYPE 2 36161847f8eSopenharmony_ci * 36261847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 36361847f8eSopenharmony_ci * @since 9 36461847f8eSopenharmony_ci */ 36561847f8eSopenharmony_ci /** 36661847f8eSopenharmony_ci * NFC FORUM TYPE 2 36761847f8eSopenharmony_ci * 36861847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 36961847f8eSopenharmony_ci * @atomicservice 37061847f8eSopenharmony_ci * @since 12 37161847f8eSopenharmony_ci */ 37261847f8eSopenharmony_ci NFC_FORUM_TYPE_2 = 2, 37361847f8eSopenharmony_ci 37461847f8eSopenharmony_ci /** 37561847f8eSopenharmony_ci * NFC FORUM TYPE 3 37661847f8eSopenharmony_ci * 37761847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 37861847f8eSopenharmony_ci * @since 9 37961847f8eSopenharmony_ci */ 38061847f8eSopenharmony_ci /** 38161847f8eSopenharmony_ci * NFC FORUM TYPE 3 38261847f8eSopenharmony_ci * 38361847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 38461847f8eSopenharmony_ci * @atomicservice 38561847f8eSopenharmony_ci * @since 12 38661847f8eSopenharmony_ci */ 38761847f8eSopenharmony_ci NFC_FORUM_TYPE_3 = 3, 38861847f8eSopenharmony_ci 38961847f8eSopenharmony_ci /** 39061847f8eSopenharmony_ci * NFC FORUM TYPE 4 39161847f8eSopenharmony_ci * 39261847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 39361847f8eSopenharmony_ci * @since 9 39461847f8eSopenharmony_ci */ 39561847f8eSopenharmony_ci /** 39661847f8eSopenharmony_ci * NFC FORUM TYPE 4 39761847f8eSopenharmony_ci * 39861847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 39961847f8eSopenharmony_ci * @atomicservice 40061847f8eSopenharmony_ci * @since 12 40161847f8eSopenharmony_ci */ 40261847f8eSopenharmony_ci NFC_FORUM_TYPE_4 = 4, 40361847f8eSopenharmony_ci 40461847f8eSopenharmony_ci /** 40561847f8eSopenharmony_ci * Mifare Classic 40661847f8eSopenharmony_ci * 40761847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 40861847f8eSopenharmony_ci * @since 9 40961847f8eSopenharmony_ci */ 41061847f8eSopenharmony_ci /** 41161847f8eSopenharmony_ci * Mifare Classic 41261847f8eSopenharmony_ci * 41361847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 41461847f8eSopenharmony_ci * @atomicservice 41561847f8eSopenharmony_ci * @since 12 41661847f8eSopenharmony_ci */ 41761847f8eSopenharmony_ci MIFARE_CLASSIC = 101 41861847f8eSopenharmony_ci } 41961847f8eSopenharmony_ci 42061847f8eSopenharmony_ci /** 42161847f8eSopenharmony_ci * RTD type TEXT, see NFC Record Type Definition (RTD) Specification. 42261847f8eSopenharmony_ci * 42361847f8eSopenharmony_ci * @constant 42461847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 42561847f8eSopenharmony_ci * @since 9 42661847f8eSopenharmony_ci */ 42761847f8eSopenharmony_ci /** 42861847f8eSopenharmony_ci * RTD type TEXT, see NFC Record Type Definition (RTD) Specification. 42961847f8eSopenharmony_ci * 43061847f8eSopenharmony_ci * @constant 43161847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 43261847f8eSopenharmony_ci * @atomicservice 43361847f8eSopenharmony_ci * @since 12 43461847f8eSopenharmony_ci */ 43561847f8eSopenharmony_ci const RTD_TEXT: number[]; 43661847f8eSopenharmony_ci 43761847f8eSopenharmony_ci /** 43861847f8eSopenharmony_ci * RTD type URI, see NFC Record Type Definition (RTD) Specification. 43961847f8eSopenharmony_ci * 44061847f8eSopenharmony_ci * @constant 44161847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 44261847f8eSopenharmony_ci * @since 9 44361847f8eSopenharmony_ci */ 44461847f8eSopenharmony_ci /** 44561847f8eSopenharmony_ci * RTD type URI, see NFC Record Type Definition (RTD) Specification. 44661847f8eSopenharmony_ci * 44761847f8eSopenharmony_ci * @constant 44861847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 44961847f8eSopenharmony_ci * @atomicservice 45061847f8eSopenharmony_ci * @since 12 45161847f8eSopenharmony_ci */ 45261847f8eSopenharmony_ci const RTD_URI: number[]; 45361847f8eSopenharmony_ci 45461847f8eSopenharmony_ci /** 45561847f8eSopenharmony_ci * MifareClassic Type definition 45661847f8eSopenharmony_ci * 45761847f8eSopenharmony_ci * @enum { number } 45861847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 45961847f8eSopenharmony_ci * @since 9 46061847f8eSopenharmony_ci */ 46161847f8eSopenharmony_ci /** 46261847f8eSopenharmony_ci * MifareClassic Type definition 46361847f8eSopenharmony_ci * 46461847f8eSopenharmony_ci * @enum { number } 46561847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 46661847f8eSopenharmony_ci * @atomicservice 46761847f8eSopenharmony_ci * @since 12 46861847f8eSopenharmony_ci */ 46961847f8eSopenharmony_ci enum MifareClassicType { 47061847f8eSopenharmony_ci /** 47161847f8eSopenharmony_ci * Mifare Type unknown 47261847f8eSopenharmony_ci * 47361847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 47461847f8eSopenharmony_ci * @since 9 47561847f8eSopenharmony_ci */ 47661847f8eSopenharmony_ci /** 47761847f8eSopenharmony_ci * Mifare Type unknown 47861847f8eSopenharmony_ci * 47961847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 48061847f8eSopenharmony_ci * @atomicservice 48161847f8eSopenharmony_ci * @since 12 48261847f8eSopenharmony_ci */ 48361847f8eSopenharmony_ci TYPE_UNKNOWN = 0, 48461847f8eSopenharmony_ci 48561847f8eSopenharmony_ci /** 48661847f8eSopenharmony_ci * Mifare Classic 48761847f8eSopenharmony_ci * 48861847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 48961847f8eSopenharmony_ci * @since 9 49061847f8eSopenharmony_ci */ 49161847f8eSopenharmony_ci /** 49261847f8eSopenharmony_ci * Mifare Classic 49361847f8eSopenharmony_ci * 49461847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 49561847f8eSopenharmony_ci * @atomicservice 49661847f8eSopenharmony_ci * @since 12 49761847f8eSopenharmony_ci */ 49861847f8eSopenharmony_ci TYPE_CLASSIC = 1, 49961847f8eSopenharmony_ci 50061847f8eSopenharmony_ci /** 50161847f8eSopenharmony_ci * Mifare Plus 50261847f8eSopenharmony_ci * 50361847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 50461847f8eSopenharmony_ci * @since 9 50561847f8eSopenharmony_ci */ 50661847f8eSopenharmony_ci /** 50761847f8eSopenharmony_ci * Mifare Plus 50861847f8eSopenharmony_ci * 50961847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 51061847f8eSopenharmony_ci * @atomicservice 51161847f8eSopenharmony_ci * @since 12 51261847f8eSopenharmony_ci */ 51361847f8eSopenharmony_ci TYPE_PLUS = 2, 51461847f8eSopenharmony_ci 51561847f8eSopenharmony_ci /** 51661847f8eSopenharmony_ci * Mifare Pro 51761847f8eSopenharmony_ci * 51861847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 51961847f8eSopenharmony_ci * @since 9 52061847f8eSopenharmony_ci */ 52161847f8eSopenharmony_ci /** 52261847f8eSopenharmony_ci * Mifare Pro 52361847f8eSopenharmony_ci * 52461847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 52561847f8eSopenharmony_ci * @atomicservice 52661847f8eSopenharmony_ci * @since 12 52761847f8eSopenharmony_ci */ 52861847f8eSopenharmony_ci TYPE_PRO = 3 52961847f8eSopenharmony_ci } 53061847f8eSopenharmony_ci 53161847f8eSopenharmony_ci /** 53261847f8eSopenharmony_ci * MifareClassic Tag size. 53361847f8eSopenharmony_ci * 53461847f8eSopenharmony_ci * @enum { number } 53561847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 53661847f8eSopenharmony_ci * @since 9 53761847f8eSopenharmony_ci */ 53861847f8eSopenharmony_ci /** 53961847f8eSopenharmony_ci * MifareClassic Tag size. 54061847f8eSopenharmony_ci * 54161847f8eSopenharmony_ci * @enum { number } 54261847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 54361847f8eSopenharmony_ci * @atomicservice 54461847f8eSopenharmony_ci * @since 12 54561847f8eSopenharmony_ci */ 54661847f8eSopenharmony_ci enum MifareClassicSize { 54761847f8eSopenharmony_ci /** 54861847f8eSopenharmony_ci * 5 sectors per tag, 4 blocks per sector 54961847f8eSopenharmony_ci * 55061847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 55161847f8eSopenharmony_ci * @since 9 55261847f8eSopenharmony_ci */ 55361847f8eSopenharmony_ci /** 55461847f8eSopenharmony_ci * 5 sectors per tag, 4 blocks per sector 55561847f8eSopenharmony_ci * 55661847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 55761847f8eSopenharmony_ci * @atomicservice 55861847f8eSopenharmony_ci * @since 12 55961847f8eSopenharmony_ci */ 56061847f8eSopenharmony_ci MC_SIZE_MINI = 320, 56161847f8eSopenharmony_ci 56261847f8eSopenharmony_ci /** 56361847f8eSopenharmony_ci * 16 sectors per tag, 4 blocks per sector 56461847f8eSopenharmony_ci * 56561847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 56661847f8eSopenharmony_ci * @since 9 56761847f8eSopenharmony_ci */ 56861847f8eSopenharmony_ci /** 56961847f8eSopenharmony_ci * 16 sectors per tag, 4 blocks per sector 57061847f8eSopenharmony_ci * 57161847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 57261847f8eSopenharmony_ci * @atomicservice 57361847f8eSopenharmony_ci * @since 12 57461847f8eSopenharmony_ci */ 57561847f8eSopenharmony_ci MC_SIZE_1K = 1024, 57661847f8eSopenharmony_ci 57761847f8eSopenharmony_ci /** 57861847f8eSopenharmony_ci * 32 sectors per tag, 4 blocks per sector 57961847f8eSopenharmony_ci * 58061847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 58161847f8eSopenharmony_ci * @since 9 58261847f8eSopenharmony_ci */ 58361847f8eSopenharmony_ci /** 58461847f8eSopenharmony_ci * 32 sectors per tag, 4 blocks per sector 58561847f8eSopenharmony_ci * 58661847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 58761847f8eSopenharmony_ci * @atomicservice 58861847f8eSopenharmony_ci * @since 12 58961847f8eSopenharmony_ci */ 59061847f8eSopenharmony_ci MC_SIZE_2K = 2048, 59161847f8eSopenharmony_ci 59261847f8eSopenharmony_ci /** 59361847f8eSopenharmony_ci * 40 sectors per tag, 4 blocks per sector 59461847f8eSopenharmony_ci * 59561847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 59661847f8eSopenharmony_ci * @since 9 59761847f8eSopenharmony_ci */ 59861847f8eSopenharmony_ci /** 59961847f8eSopenharmony_ci * 40 sectors per tag, 4 blocks per sector 60061847f8eSopenharmony_ci * 60161847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 60261847f8eSopenharmony_ci * @atomicservice 60361847f8eSopenharmony_ci * @since 12 60461847f8eSopenharmony_ci */ 60561847f8eSopenharmony_ci MC_SIZE_4K = 4096 60661847f8eSopenharmony_ci } 60761847f8eSopenharmony_ci 60861847f8eSopenharmony_ci /** 60961847f8eSopenharmony_ci * MifareUltralight Type definition 61061847f8eSopenharmony_ci * 61161847f8eSopenharmony_ci * @enum { number } 61261847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 61361847f8eSopenharmony_ci * @since 9 61461847f8eSopenharmony_ci */ 61561847f8eSopenharmony_ci /** 61661847f8eSopenharmony_ci * MifareUltralight Type definition 61761847f8eSopenharmony_ci * 61861847f8eSopenharmony_ci * @enum { number } 61961847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 62061847f8eSopenharmony_ci * @atomicservice 62161847f8eSopenharmony_ci * @since 12 62261847f8eSopenharmony_ci */ 62361847f8eSopenharmony_ci enum MifareUltralightType { 62461847f8eSopenharmony_ci /** 62561847f8eSopenharmony_ci * Mifare Type unknown 62661847f8eSopenharmony_ci * 62761847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 62861847f8eSopenharmony_ci * @since 9 62961847f8eSopenharmony_ci */ 63061847f8eSopenharmony_ci /** 63161847f8eSopenharmony_ci * Mifare Type unknown 63261847f8eSopenharmony_ci * 63361847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 63461847f8eSopenharmony_ci * @atomicservice 63561847f8eSopenharmony_ci * @since 12 63661847f8eSopenharmony_ci */ 63761847f8eSopenharmony_ci TYPE_UNKNOWN = 0, 63861847f8eSopenharmony_ci 63961847f8eSopenharmony_ci /** 64061847f8eSopenharmony_ci * Mifare Ultralight 64161847f8eSopenharmony_ci * 64261847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 64361847f8eSopenharmony_ci * @since 9 64461847f8eSopenharmony_ci */ 64561847f8eSopenharmony_ci /** 64661847f8eSopenharmony_ci * Mifare Ultralight 64761847f8eSopenharmony_ci * 64861847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 64961847f8eSopenharmony_ci * @atomicservice 65061847f8eSopenharmony_ci * @since 12 65161847f8eSopenharmony_ci */ 65261847f8eSopenharmony_ci TYPE_ULTRALIGHT = 1, 65361847f8eSopenharmony_ci 65461847f8eSopenharmony_ci /** 65561847f8eSopenharmony_ci * Mifare UltralightC 65661847f8eSopenharmony_ci * 65761847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 65861847f8eSopenharmony_ci * @since 9 65961847f8eSopenharmony_ci */ 66061847f8eSopenharmony_ci /** 66161847f8eSopenharmony_ci * Mifare UltralightC 66261847f8eSopenharmony_ci * 66361847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 66461847f8eSopenharmony_ci * @atomicservice 66561847f8eSopenharmony_ci * @since 12 66661847f8eSopenharmony_ci */ 66761847f8eSopenharmony_ci TYPE_ULTRALIGHT_C = 2 66861847f8eSopenharmony_ci } 66961847f8eSopenharmony_ci 67061847f8eSopenharmony_ci /** 67161847f8eSopenharmony_ci * Obtains an {@link NfcATag} object based on the tag information. 67261847f8eSopenharmony_ci * <p>During tag reading, if the tag supports the NFC-A technology, an {@link NfcATag} object 67361847f8eSopenharmony_ci * will be created based on the tag information. 67461847f8eSopenharmony_ci * 67561847f8eSopenharmony_ci * @param { TagInfo } tagInfo Indicates the tag information. 67661847f8eSopenharmony_ci * @returns { NfcATag } The {@link NfcATag} object. 67761847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 67861847f8eSopenharmony_ci * @since 7 67961847f8eSopenharmony_ci * @deprecated since 9 68061847f8eSopenharmony_ci * @useinstead ohos.nfc.tag/tag#getNfcA 68161847f8eSopenharmony_ci */ 68261847f8eSopenharmony_ci function getNfcATag(tagInfo: TagInfo): NfcATag; 68361847f8eSopenharmony_ci 68461847f8eSopenharmony_ci /** 68561847f8eSopenharmony_ci * Obtains an {@link NfcATag} object based on the tag information. 68661847f8eSopenharmony_ci * During tag reading, if the tag supports the NFC-A technology, an {@link NfcATag} object 68761847f8eSopenharmony_ci * will be created based on the tag information. 68861847f8eSopenharmony_ci * 68961847f8eSopenharmony_ci * @param { TagInfo } tagInfo - Indicates the dispatched tag information. 69061847f8eSopenharmony_ci * @returns { NfcATag } {@link NfcATag} object. 69161847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 69261847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 69361847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 69461847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 69561847f8eSopenharmony_ci * @throws { BusinessError } 801 - Capability not supported. 69661847f8eSopenharmony_ci * @throws { BusinessError } 3100201 - Tag running state is abnormal in service. 69761847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 69861847f8eSopenharmony_ci * @since 9 69961847f8eSopenharmony_ci */ 70061847f8eSopenharmony_ci /** 70161847f8eSopenharmony_ci * Obtains an {@link NfcATag} object based on the tag information. 70261847f8eSopenharmony_ci * During tag reading, if the tag supports the NFC-A technology, an {@link NfcATag} object 70361847f8eSopenharmony_ci * will be created based on the tag information. 70461847f8eSopenharmony_ci * 70561847f8eSopenharmony_ci * @param { TagInfo } tagInfo - Indicates the dispatched tag information. 70661847f8eSopenharmony_ci * @returns { NfcATag } {@link NfcATag} object. 70761847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 70861847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 70961847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 71061847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 71161847f8eSopenharmony_ci * @throws { BusinessError } 801 - Capability not supported. 71261847f8eSopenharmony_ci * @throws { BusinessError } 3100201 - Tag running state is abnormal in service. 71361847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 71461847f8eSopenharmony_ci * @atomicservice 71561847f8eSopenharmony_ci * @since 12 71661847f8eSopenharmony_ci */ 71761847f8eSopenharmony_ci function getNfcA(tagInfo: TagInfo): NfcATag; 71861847f8eSopenharmony_ci 71961847f8eSopenharmony_ci /** 72061847f8eSopenharmony_ci * Obtains an {@link NfcBTag} object based on the tag information. 72161847f8eSopenharmony_ci * <p>During tag reading, if the tag supports the NFC-B technology, an {@link NfcBTag} object 72261847f8eSopenharmony_ci * will be created based on the tag information. 72361847f8eSopenharmony_ci * 72461847f8eSopenharmony_ci * @param { TagInfo } tagInfo Indicates the tag information. 72561847f8eSopenharmony_ci * @returns { NfcBTag } The {@link NfcBTag} object. 72661847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 72761847f8eSopenharmony_ci * @since 7 72861847f8eSopenharmony_ci * @deprecated since 9 72961847f8eSopenharmony_ci * @useinstead ohos.nfc.tag/tag#getNfcB 73061847f8eSopenharmony_ci */ 73161847f8eSopenharmony_ci function getNfcBTag(tagInfo: TagInfo): NfcBTag; 73261847f8eSopenharmony_ci 73361847f8eSopenharmony_ci /** 73461847f8eSopenharmony_ci * Obtains an {@link NfcBTag} object based on the tag information. 73561847f8eSopenharmony_ci * During tag reading, if the tag supports the NFC-B technology, an {@link NfcBTag} object 73661847f8eSopenharmony_ci * will be created based on the tag information. 73761847f8eSopenharmony_ci * 73861847f8eSopenharmony_ci * @param { TagInfo } tagInfo - Indicates the dispatched tag information. 73961847f8eSopenharmony_ci * @returns { NfcBTag } The {@link NfcBTag} object. 74061847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 74161847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 74261847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 74361847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 74461847f8eSopenharmony_ci * @throws { BusinessError } 801 - Capability not supported. 74561847f8eSopenharmony_ci * @throws { BusinessError } 3100201 - Tag running state is abnormal in service. 74661847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 74761847f8eSopenharmony_ci * @since 9 74861847f8eSopenharmony_ci */ 74961847f8eSopenharmony_ci /** 75061847f8eSopenharmony_ci * Obtains an {@link NfcBTag} object based on the tag information. 75161847f8eSopenharmony_ci * During tag reading, if the tag supports the NFC-B technology, an {@link NfcBTag} object 75261847f8eSopenharmony_ci * will be created based on the tag information. 75361847f8eSopenharmony_ci * 75461847f8eSopenharmony_ci * @param { TagInfo } tagInfo - Indicates the dispatched tag information. 75561847f8eSopenharmony_ci * @returns { NfcBTag } The {@link NfcBTag} object. 75661847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 75761847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 75861847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 75961847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 76061847f8eSopenharmony_ci * @throws { BusinessError } 801 - Capability not supported. 76161847f8eSopenharmony_ci * @throws { BusinessError } 3100201 - Tag running state is abnormal in service. 76261847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 76361847f8eSopenharmony_ci * @atomicservice 76461847f8eSopenharmony_ci * @since 12 76561847f8eSopenharmony_ci */ 76661847f8eSopenharmony_ci function getNfcB(tagInfo: TagInfo): NfcBTag; 76761847f8eSopenharmony_ci 76861847f8eSopenharmony_ci /** 76961847f8eSopenharmony_ci * Obtains an {@link NfcFTag} object based on the tag information. 77061847f8eSopenharmony_ci * <p>During tag reading, if the tag supports the NFC-F technology, an {@link NfcFTag} object 77161847f8eSopenharmony_ci * will be created based on the tag information. 77261847f8eSopenharmony_ci * 77361847f8eSopenharmony_ci * @param { TagInfo } tagInfo Indicates the tag information. 77461847f8eSopenharmony_ci * @returns { NfcFTag } The {@link NfcFTag} object. 77561847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 77661847f8eSopenharmony_ci * @since 7 77761847f8eSopenharmony_ci * @deprecated since 9 77861847f8eSopenharmony_ci * @useinstead ohos.nfc.tag/tag#getNfcF 77961847f8eSopenharmony_ci */ 78061847f8eSopenharmony_ci function getNfcFTag(tagInfo: TagInfo): NfcFTag; 78161847f8eSopenharmony_ci 78261847f8eSopenharmony_ci /** 78361847f8eSopenharmony_ci * Obtains an {@link NfcFTag} object based on the tag information. 78461847f8eSopenharmony_ci * During tag reading, if the tag supports the NFC-F technology, an {@link NfcFTag} object 78561847f8eSopenharmony_ci * will be created based on the tag information. 78661847f8eSopenharmony_ci * 78761847f8eSopenharmony_ci * @param { TagInfo } tagInfo - Indicates the dispatched tag information. 78861847f8eSopenharmony_ci * @returns { NfcFTag } The {@link NfcFTag} object. 78961847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 79061847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 79161847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 79261847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 79361847f8eSopenharmony_ci * @throws { BusinessError } 801 - Capability not supported. 79461847f8eSopenharmony_ci * @throws { BusinessError } 3100201 - Tag running state is abnormal in service. 79561847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 79661847f8eSopenharmony_ci * @since 9 79761847f8eSopenharmony_ci */ 79861847f8eSopenharmony_ci /** 79961847f8eSopenharmony_ci * Obtains an {@link NfcFTag} object based on the tag information. 80061847f8eSopenharmony_ci * During tag reading, if the tag supports the NFC-F technology, an {@link NfcFTag} object 80161847f8eSopenharmony_ci * will be created based on the tag information. 80261847f8eSopenharmony_ci * 80361847f8eSopenharmony_ci * @param { TagInfo } tagInfo - Indicates the dispatched tag information. 80461847f8eSopenharmony_ci * @returns { NfcFTag } The {@link NfcFTag} object. 80561847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 80661847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 80761847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 80861847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 80961847f8eSopenharmony_ci * @throws { BusinessError } 801 - Capability not supported. 81061847f8eSopenharmony_ci * @throws { BusinessError } 3100201 - Tag running state is abnormal in service. 81161847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 81261847f8eSopenharmony_ci * @atomicservice 81361847f8eSopenharmony_ci * @since 12 81461847f8eSopenharmony_ci */ 81561847f8eSopenharmony_ci function getNfcF(tagInfo: TagInfo): NfcFTag; 81661847f8eSopenharmony_ci 81761847f8eSopenharmony_ci /** 81861847f8eSopenharmony_ci * Obtains an {@link NfcVTag} object based on the tag information. 81961847f8eSopenharmony_ci * <p>During tag reading, if the tag supports the NFC-V technology, an {@link NfcVTag} object 82061847f8eSopenharmony_ci * will be created based on the tag information. 82161847f8eSopenharmony_ci * 82261847f8eSopenharmony_ci * @param { TagInfo } tagInfo Indicates the tag information. 82361847f8eSopenharmony_ci * @returns { NfcVTag } The {@link NfcVTag} object. 82461847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 82561847f8eSopenharmony_ci * @since 7 82661847f8eSopenharmony_ci * @deprecated since 9 82761847f8eSopenharmony_ci * @useinstead ohos.nfc.tag/tag#getNfcV 82861847f8eSopenharmony_ci */ 82961847f8eSopenharmony_ci function getNfcVTag(tagInfo: TagInfo): NfcVTag; 83061847f8eSopenharmony_ci 83161847f8eSopenharmony_ci /** 83261847f8eSopenharmony_ci * Obtains an {@link NfcVTag} object based on the tag information. 83361847f8eSopenharmony_ci * During tag reading, if the tag supports the NFC-V technology, an {@link NfcVTag} object 83461847f8eSopenharmony_ci * will be created based on the tag information. 83561847f8eSopenharmony_ci * 83661847f8eSopenharmony_ci * @param { TagInfo } tagInfo - Indicates the dispatched tag information. 83761847f8eSopenharmony_ci * @returns { NfcVTag } The {@link NfcVTag} object. 83861847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 83961847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 84061847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 84161847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 84261847f8eSopenharmony_ci * @throws { BusinessError } 801 - Capability not supported. 84361847f8eSopenharmony_ci * @throws { BusinessError } 3100201 - Tag running state is abnormal in service. 84461847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 84561847f8eSopenharmony_ci * @since 9 84661847f8eSopenharmony_ci */ 84761847f8eSopenharmony_ci /** 84861847f8eSopenharmony_ci * Obtains an {@link NfcVTag} object based on the tag information. 84961847f8eSopenharmony_ci * During tag reading, if the tag supports the NFC-V technology, an {@link NfcVTag} object 85061847f8eSopenharmony_ci * will be created based on the tag information. 85161847f8eSopenharmony_ci * 85261847f8eSopenharmony_ci * @param { TagInfo } tagInfo - Indicates the dispatched tag information. 85361847f8eSopenharmony_ci * @returns { NfcVTag } The {@link NfcVTag} object. 85461847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 85561847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 85661847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 85761847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 85861847f8eSopenharmony_ci * @throws { BusinessError } 801 - Capability not supported. 85961847f8eSopenharmony_ci * @throws { BusinessError } 3100201 - Tag running state is abnormal in service. 86061847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 86161847f8eSopenharmony_ci * @atomicservice 86261847f8eSopenharmony_ci * @since 12 86361847f8eSopenharmony_ci */ 86461847f8eSopenharmony_ci function getNfcV(tagInfo: TagInfo): NfcVTag; 86561847f8eSopenharmony_ci 86661847f8eSopenharmony_ci /** 86761847f8eSopenharmony_ci * Obtains an {@link IsoDepTag} object based on the tag information. 86861847f8eSopenharmony_ci * During tag reading, if the tag supports the IsoDep technology, an {@link IsoDepTag} object 86961847f8eSopenharmony_ci * will be created based on the tag information. 87061847f8eSopenharmony_ci * 87161847f8eSopenharmony_ci * @param { TagInfo } tagInfo - Indicates the dispatched tag information. 87261847f8eSopenharmony_ci * @returns { IsoDepTag } The {@link IsoDepTag} object. 87361847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 87461847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 87561847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 87661847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 87761847f8eSopenharmony_ci * @throws { BusinessError } 801 - Capability not supported. 87861847f8eSopenharmony_ci * @throws { BusinessError } 3100201 - Tag running state is abnormal in service. 87961847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 88061847f8eSopenharmony_ci * @since 9 88161847f8eSopenharmony_ci */ 88261847f8eSopenharmony_ci /** 88361847f8eSopenharmony_ci * Obtains an {@link IsoDepTag} object based on the tag information. 88461847f8eSopenharmony_ci * During tag reading, if the tag supports the IsoDep technology, an {@link IsoDepTag} object 88561847f8eSopenharmony_ci * will be created based on the tag information. 88661847f8eSopenharmony_ci * 88761847f8eSopenharmony_ci * @param { TagInfo } tagInfo - Indicates the dispatched tag information. 88861847f8eSopenharmony_ci * @returns { IsoDepTag } The {@link IsoDepTag} object. 88961847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 89061847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 89161847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 89261847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 89361847f8eSopenharmony_ci * @throws { BusinessError } 801 - Capability not supported. 89461847f8eSopenharmony_ci * @throws { BusinessError } 3100201 - Tag running state is abnormal in service. 89561847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 89661847f8eSopenharmony_ci * @atomicservice 89761847f8eSopenharmony_ci * @since 12 89861847f8eSopenharmony_ci */ 89961847f8eSopenharmony_ci function getIsoDep(tagInfo: TagInfo): IsoDepTag; 90061847f8eSopenharmony_ci 90161847f8eSopenharmony_ci /** 90261847f8eSopenharmony_ci * Obtains an {@link NdefTag} object based on the tag information. 90361847f8eSopenharmony_ci * During tag reading, if the tag supports the NDEF technology, an {@link NdefTag} object 90461847f8eSopenharmony_ci * will be created based on the tag information. 90561847f8eSopenharmony_ci * 90661847f8eSopenharmony_ci * @param { TagInfo } tagInfo - Indicates the dispatched tag information. 90761847f8eSopenharmony_ci * @returns { NdefTag } The {@link NdefTag} object. 90861847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 90961847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 91061847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 91161847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 91261847f8eSopenharmony_ci * @throws { BusinessError } 801 - Capability not supported. 91361847f8eSopenharmony_ci * @throws { BusinessError } 3100201 - Tag running state is abnormal in service. 91461847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 91561847f8eSopenharmony_ci * @since 9 91661847f8eSopenharmony_ci */ 91761847f8eSopenharmony_ci /** 91861847f8eSopenharmony_ci * Obtains an {@link NdefTag} object based on the tag information. 91961847f8eSopenharmony_ci * During tag reading, if the tag supports the NDEF technology, an {@link NdefTag} object 92061847f8eSopenharmony_ci * will be created based on the tag information. 92161847f8eSopenharmony_ci * 92261847f8eSopenharmony_ci * @param { TagInfo } tagInfo - Indicates the dispatched tag information. 92361847f8eSopenharmony_ci * @returns { NdefTag } The {@link NdefTag} object. 92461847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 92561847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 92661847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 92761847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 92861847f8eSopenharmony_ci * @throws { BusinessError } 801 - Capability not supported. 92961847f8eSopenharmony_ci * @throws { BusinessError } 3100201 - Tag running state is abnormal in service. 93061847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 93161847f8eSopenharmony_ci * @atomicservice 93261847f8eSopenharmony_ci * @since 12 93361847f8eSopenharmony_ci */ 93461847f8eSopenharmony_ci function getNdef(tagInfo: TagInfo): NdefTag; 93561847f8eSopenharmony_ci 93661847f8eSopenharmony_ci /** 93761847f8eSopenharmony_ci * Obtains an {@link MifareClassicTag} object based on the tag information. 93861847f8eSopenharmony_ci * During tag reading, if the tag supports the MIFARE Classic technology, 93961847f8eSopenharmony_ci * an {@link MifareClassicTag} object will be created based on the tag information. 94061847f8eSopenharmony_ci * 94161847f8eSopenharmony_ci * @param { TagInfo } tagInfo - Indicates the dispatched tag information. 94261847f8eSopenharmony_ci * @returns { MifareClassicTag } The {@link MifareClassicTag} object. 94361847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 94461847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 94561847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 94661847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 94761847f8eSopenharmony_ci * @throws { BusinessError } 801 - Capability not supported. 94861847f8eSopenharmony_ci * @throws { BusinessError } 3100201 - Tag running state is abnormal in service. 94961847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 95061847f8eSopenharmony_ci * @since 9 95161847f8eSopenharmony_ci */ 95261847f8eSopenharmony_ci /** 95361847f8eSopenharmony_ci * Obtains an {@link MifareClassicTag} object based on the tag information. 95461847f8eSopenharmony_ci * During tag reading, if the tag supports the MIFARE Classic technology, 95561847f8eSopenharmony_ci * an {@link MifareClassicTag} object will be created based on the tag information. 95661847f8eSopenharmony_ci * 95761847f8eSopenharmony_ci * @param { TagInfo } tagInfo - Indicates the dispatched tag information. 95861847f8eSopenharmony_ci * @returns { MifareClassicTag } The {@link MifareClassicTag} object. 95961847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 96061847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 96161847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 96261847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 96361847f8eSopenharmony_ci * @throws { BusinessError } 801 - Capability not supported. 96461847f8eSopenharmony_ci * @throws { BusinessError } 3100201 - Tag running state is abnormal in service. 96561847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 96661847f8eSopenharmony_ci * @atomicservice 96761847f8eSopenharmony_ci * @since 12 96861847f8eSopenharmony_ci */ 96961847f8eSopenharmony_ci function getMifareClassic(tagInfo: TagInfo): MifareClassicTag; 97061847f8eSopenharmony_ci 97161847f8eSopenharmony_ci /** 97261847f8eSopenharmony_ci * Obtains an {@link MifareUltralightTag} object based on the tag information. 97361847f8eSopenharmony_ci * During tag reading, if the tag supports the MIFARE Ultralight technology, 97461847f8eSopenharmony_ci * an {@link MifareUltralightTag} object will be created based on the tag information. 97561847f8eSopenharmony_ci * 97661847f8eSopenharmony_ci * @param { TagInfo } tagInfo - Indicates the dispatched tag information. 97761847f8eSopenharmony_ci * @returns { MifareUltralightTag } The {@link MifareUltralightTag} object. 97861847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 97961847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 98061847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 98161847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 98261847f8eSopenharmony_ci * @throws { BusinessError } 801 - Capability not supported. 98361847f8eSopenharmony_ci * @throws { BusinessError } 3100201 - Tag running state is abnormal in service. 98461847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 98561847f8eSopenharmony_ci * @since 9 98661847f8eSopenharmony_ci */ 98761847f8eSopenharmony_ci /** 98861847f8eSopenharmony_ci * Obtains an {@link MifareUltralightTag} object based on the tag information. 98961847f8eSopenharmony_ci * During tag reading, if the tag supports the MIFARE Ultralight technology, 99061847f8eSopenharmony_ci * an {@link MifareUltralightTag} object will be created based on the tag information. 99161847f8eSopenharmony_ci * 99261847f8eSopenharmony_ci * @param { TagInfo } tagInfo - Indicates the dispatched tag information. 99361847f8eSopenharmony_ci * @returns { MifareUltralightTag } The {@link MifareUltralightTag} object. 99461847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 99561847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 99661847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 99761847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 99861847f8eSopenharmony_ci * @throws { BusinessError } 801 - Capability not supported. 99961847f8eSopenharmony_ci * @throws { BusinessError } 3100201 - Tag running state is abnormal in service. 100061847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 100161847f8eSopenharmony_ci * @atomicservice 100261847f8eSopenharmony_ci * @since 12 100361847f8eSopenharmony_ci */ 100461847f8eSopenharmony_ci function getMifareUltralight(tagInfo: TagInfo): MifareUltralightTag; 100561847f8eSopenharmony_ci 100661847f8eSopenharmony_ci /** 100761847f8eSopenharmony_ci * Obtains an {@link NdefFormatableTag} object based on the tag information. 100861847f8eSopenharmony_ci * During tag reading, if the tag supports the NDEF Formatable technology, 100961847f8eSopenharmony_ci * an {@link NdefFormatableTag} object will be created based on the tag information. 101061847f8eSopenharmony_ci * 101161847f8eSopenharmony_ci * @param { TagInfo } tagInfo - Indicates the dispatched tag information. 101261847f8eSopenharmony_ci * @returns { NdefFormatableTag } The {@link NdefFormatableTag} object. 101361847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 101461847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 101561847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 101661847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 101761847f8eSopenharmony_ci * @throws { BusinessError } 801 - Capability not supported. 101861847f8eSopenharmony_ci * @throws { BusinessError } 3100201 - Tag running state is abnormal in service. 101961847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 102061847f8eSopenharmony_ci * @since 9 102161847f8eSopenharmony_ci */ 102261847f8eSopenharmony_ci /** 102361847f8eSopenharmony_ci * Obtains an {@link NdefFormatableTag} object based on the tag information. 102461847f8eSopenharmony_ci * During tag reading, if the tag supports the NDEF Formatable technology, 102561847f8eSopenharmony_ci * an {@link NdefFormatableTag} object will be created based on the tag information. 102661847f8eSopenharmony_ci * 102761847f8eSopenharmony_ci * @param { TagInfo } tagInfo - Indicates the dispatched tag information. 102861847f8eSopenharmony_ci * @returns { NdefFormatableTag } The {@link NdefFormatableTag} object. 102961847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 103061847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 103161847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 103261847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 103361847f8eSopenharmony_ci * @throws { BusinessError } 801 - Capability not supported. 103461847f8eSopenharmony_ci * @throws { BusinessError } 3100201 - Tag running state is abnormal in service. 103561847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 103661847f8eSopenharmony_ci * @atomicservice 103761847f8eSopenharmony_ci * @since 12 103861847f8eSopenharmony_ci */ 103961847f8eSopenharmony_ci function getNdefFormatable(tagInfo: TagInfo): NdefFormatableTag; 104061847f8eSopenharmony_ci 104161847f8eSopenharmony_ci /** 104261847f8eSopenharmony_ci * Parse a {@link TagInfo} object from Want. 104361847f8eSopenharmony_ci * 104461847f8eSopenharmony_ci * @param { Want } want - The want object that contains the values of TagInfo. 104561847f8eSopenharmony_ci * @returns { TagInfo } The {@link TagInfo} object. 104661847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 104761847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 104861847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 104961847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 105061847f8eSopenharmony_ci * @throws { BusinessError } 801 - Capability not supported. 105161847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 105261847f8eSopenharmony_ci * @since 9 105361847f8eSopenharmony_ci */ 105461847f8eSopenharmony_ci /** 105561847f8eSopenharmony_ci * Parse a {@link TagInfo} object from Want. 105661847f8eSopenharmony_ci * 105761847f8eSopenharmony_ci * @param { Want } want - The want object that contains the values of TagInfo. 105861847f8eSopenharmony_ci * @returns { TagInfo } The {@link TagInfo} object. 105961847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 106061847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 106161847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 106261847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 106361847f8eSopenharmony_ci * @throws { BusinessError } 801 - Capability not supported. 106461847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 106561847f8eSopenharmony_ci * @atomicservice 106661847f8eSopenharmony_ci * @since 12 106761847f8eSopenharmony_ci */ 106861847f8eSopenharmony_ci function getTagInfo(want: Want): TagInfo; 106961847f8eSopenharmony_ci 107061847f8eSopenharmony_ci /** 107161847f8eSopenharmony_ci * Register tag foreground dispatch. Dispatches to this application only if a tag discovered. 107261847f8eSopenharmony_ci * 107361847f8eSopenharmony_ci * @permission ohos.permission.NFC_TAG 107461847f8eSopenharmony_ci * @param { ElementName } elementName - The element name of application, must include the bundleName and abilityName. 107561847f8eSopenharmony_ci * @param { number[] } discTech - The technologies list to set for discovering. From {@link NFC_A} to {@link MIFARE_ULTRALIGHT}. 107661847f8eSopenharmony_ci * @param { AsyncCallback<TagInfo> } callback - The callback to dispatched the TagInfo object for application. 107761847f8eSopenharmony_ci * @throws { BusinessError } 201 - Permission denied. 107861847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 107961847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 108061847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 108161847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 108261847f8eSopenharmony_ci * @throws { BusinessError } 801 - Capability not supported. 108361847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 108461847f8eSopenharmony_ci * @since 10 108561847f8eSopenharmony_ci */ 108661847f8eSopenharmony_ci /** 108761847f8eSopenharmony_ci * Register tag foreground dispatch. Dispatches to this application only if a tag discovered. 108861847f8eSopenharmony_ci * 108961847f8eSopenharmony_ci * @permission ohos.permission.NFC_TAG 109061847f8eSopenharmony_ci * @param { ElementName } elementName - The element name of application, must include the bundleName and abilityName. 109161847f8eSopenharmony_ci * @param { number[] } discTech - The technologies list to set for discovering. From {@link NFC_A} to {@link MIFARE_ULTRALIGHT}. 109261847f8eSopenharmony_ci * @param { AsyncCallback<TagInfo> } callback - The callback to dispatched the TagInfo object for application. 109361847f8eSopenharmony_ci * @throws { BusinessError } 201 - Permission denied. 109461847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 109561847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 109661847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 109761847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 109861847f8eSopenharmony_ci * @throws { BusinessError } 801 - Capability not supported. 109961847f8eSopenharmony_ci * @throws { BusinessError } 3100202 - The element state is invalid. 110061847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 110161847f8eSopenharmony_ci * @atomicservice 110261847f8eSopenharmony_ci * @since 12 110361847f8eSopenharmony_ci */ 110461847f8eSopenharmony_ci function registerForegroundDispatch( 110561847f8eSopenharmony_ci elementName: ElementName, 110661847f8eSopenharmony_ci discTech: number[], 110761847f8eSopenharmony_ci callback: AsyncCallback<TagInfo> 110861847f8eSopenharmony_ci ): void; 110961847f8eSopenharmony_ci 111061847f8eSopenharmony_ci /** 111161847f8eSopenharmony_ci * Unregister tag foreground dispatch. 111261847f8eSopenharmony_ci * 111361847f8eSopenharmony_ci * @permission ohos.permission.NFC_TAG 111461847f8eSopenharmony_ci * @param { ElementName } elementName - The element name of application, must include the bundleName and abilityName. 111561847f8eSopenharmony_ci * @throws { BusinessError } 201 - Permission denied. 111661847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 111761847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 111861847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 111961847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 112061847f8eSopenharmony_ci * @throws { BusinessError } 801 - Capability not supported. 112161847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 112261847f8eSopenharmony_ci * @since 10 112361847f8eSopenharmony_ci */ 112461847f8eSopenharmony_ci /** 112561847f8eSopenharmony_ci * Unregister tag foreground dispatch. 112661847f8eSopenharmony_ci * 112761847f8eSopenharmony_ci * @permission ohos.permission.NFC_TAG 112861847f8eSopenharmony_ci * @param { ElementName } elementName - The element name of application, must include the bundleName and abilityName. 112961847f8eSopenharmony_ci * @throws { BusinessError } 201 - Permission denied. 113061847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 113161847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 113261847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 113361847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 113461847f8eSopenharmony_ci * @throws { BusinessError } 801 - Capability not supported. 113561847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 113661847f8eSopenharmony_ci * @atomicservice 113761847f8eSopenharmony_ci * @since 12 113861847f8eSopenharmony_ci */ 113961847f8eSopenharmony_ci function unregisterForegroundDispatch(elementName: ElementName): void; 114061847f8eSopenharmony_ci 114161847f8eSopenharmony_ci /** 114261847f8eSopenharmony_ci * Set reader mode enabled when the specific application is foreground. Dispatches to this application only if a tag discovered. 114361847f8eSopenharmony_ci * 114461847f8eSopenharmony_ci * @permission ohos.permission.NFC_TAG 114561847f8eSopenharmony_ci * @param { 'readerMode' } type - The callback type to be registered. 114661847f8eSopenharmony_ci * @param { ElementName } elementName - The element name of application, must include the bundleName and abilityName. 114761847f8eSopenharmony_ci * @param { number[] } discTech - The technologies list to set for discovering. From {@link NFC_A} to {@link MIFARE_ULTRALIGHT}. 114861847f8eSopenharmony_ci * @param { AsyncCallback<TagInfo> } callback - The callback to dispatched the TagInfo object for application. 114961847f8eSopenharmony_ci * @throws { BusinessError } 201 - Permission denied. 115061847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 115161847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 115261847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 115361847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 115461847f8eSopenharmony_ci * @throws { BusinessError } 801 - Capability not supported. 115561847f8eSopenharmony_ci * @throws { BusinessError } 3100202 - The element state is invalid. 115661847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 115761847f8eSopenharmony_ci * @since 11 115861847f8eSopenharmony_ci */ 115961847f8eSopenharmony_ci /** 116061847f8eSopenharmony_ci * Set reader mode enabled when the specific application is foreground. Dispatches to this application only if a tag discovered. 116161847f8eSopenharmony_ci * 116261847f8eSopenharmony_ci * @permission ohos.permission.NFC_TAG 116361847f8eSopenharmony_ci * @param { 'readerMode' } type - The callback type to be registered. 116461847f8eSopenharmony_ci * @param { ElementName } elementName - The element name of application, must include the bundleName and abilityName. 116561847f8eSopenharmony_ci * @param { number[] } discTech - The technologies list to set for discovering. From {@link NFC_A} to {@link MIFARE_ULTRALIGHT}. 116661847f8eSopenharmony_ci * @param { AsyncCallback<TagInfo> } callback - The callback to dispatched the TagInfo object for application. 116761847f8eSopenharmony_ci * @throws { BusinessError } 201 - Permission denied. 116861847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 116961847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 117061847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 117161847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 117261847f8eSopenharmony_ci * @throws { BusinessError } 801 - Capability not supported. 117361847f8eSopenharmony_ci * @throws { BusinessError } 3100202 - The element state is invalid. 117461847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 117561847f8eSopenharmony_ci * @atomicservice 117661847f8eSopenharmony_ci * @since 12 117761847f8eSopenharmony_ci */ 117861847f8eSopenharmony_ci function on(type: 'readerMode', elementName: ElementName, discTech: number[], callback: AsyncCallback<TagInfo>): void; 117961847f8eSopenharmony_ci 118061847f8eSopenharmony_ci /** 118161847f8eSopenharmony_ci * Disable foreground reader mode settings explicitly. 118261847f8eSopenharmony_ci * 118361847f8eSopenharmony_ci * @permission ohos.permission.NFC_TAG 118461847f8eSopenharmony_ci * @param { 'readerMode' } type - The callback type to be unregistered. 118561847f8eSopenharmony_ci * @param { ElementName } elementName - The element name of application, must include the bundleName and abilityName. 118661847f8eSopenharmony_ci * @param { AsyncCallback<TagInfo> } [callback] - The callback to dispatched the TagInfo object for application. 118761847f8eSopenharmony_ci * @throws { BusinessError } 201 - Permission denied. 118861847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 118961847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 119061847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 119161847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 119261847f8eSopenharmony_ci * @throws { BusinessError } 801 - Capability not supported. 119361847f8eSopenharmony_ci * @throws { BusinessError } 3100203 - The off() can be called only when the on() has been called. 119461847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 119561847f8eSopenharmony_ci * @since 11 119661847f8eSopenharmony_ci */ 119761847f8eSopenharmony_ci /** 119861847f8eSopenharmony_ci * Disable foreground reader mode settings explicitly. 119961847f8eSopenharmony_ci * 120061847f8eSopenharmony_ci * @permission ohos.permission.NFC_TAG 120161847f8eSopenharmony_ci * @param { 'readerMode' } type - The callback type to be unregistered. 120261847f8eSopenharmony_ci * @param { ElementName } elementName - The element name of application, must include the bundleName and abilityName. 120361847f8eSopenharmony_ci * @param { AsyncCallback<TagInfo> } [callback] - The callback to dispatched the TagInfo object for application. 120461847f8eSopenharmony_ci * @throws { BusinessError } 201 - Permission denied. 120561847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 120661847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 120761847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 120861847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 120961847f8eSopenharmony_ci * @throws { BusinessError } 801 - Capability not supported. 121061847f8eSopenharmony_ci * @throws { BusinessError } 3100203 - The off() can be called only when the on() has been called. 121161847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 121261847f8eSopenharmony_ci * @atomicservice 121361847f8eSopenharmony_ci * @since 12 121461847f8eSopenharmony_ci */ 121561847f8eSopenharmony_ci function off(type: 'readerMode', elementName: ElementName, callback?: AsyncCallback<TagInfo>): void; 121661847f8eSopenharmony_ci 121761847f8eSopenharmony_ci /** 121861847f8eSopenharmony_ci * Provides tag information. 121961847f8eSopenharmony_ci * <p>This class provides the technology a tag supports, for example, NFC-A. Applications can create 122061847f8eSopenharmony_ci * different tags based on the supported technology. 122161847f8eSopenharmony_ci * 122261847f8eSopenharmony_ci * @typedef TagInfo 122361847f8eSopenharmony_ci * @permission ohos.permission.NFC_TAG 122461847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 122561847f8eSopenharmony_ci * @since 7 122661847f8eSopenharmony_ci */ 122761847f8eSopenharmony_ci /** 122861847f8eSopenharmony_ci * Provides tag information. 122961847f8eSopenharmony_ci * <p>This class provides the technology a tag supports, for example, NFC-A. Applications can create 123061847f8eSopenharmony_ci * different tags based on the supported technology. 123161847f8eSopenharmony_ci * 123261847f8eSopenharmony_ci * @typedef TagInfo 123361847f8eSopenharmony_ci * @permission ohos.permission.NFC_TAG 123461847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 123561847f8eSopenharmony_ci * @atomicservice 123661847f8eSopenharmony_ci * @since 12 123761847f8eSopenharmony_ci */ 123861847f8eSopenharmony_ci export interface TagInfo { 123961847f8eSopenharmony_ci /** 124061847f8eSopenharmony_ci * The uid of this tag, it. 124161847f8eSopenharmony_ci * 124261847f8eSopenharmony_ci * @permission ohos.permission.NFC_TAG 124361847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 124461847f8eSopenharmony_ci * @since 9 124561847f8eSopenharmony_ci */ 124661847f8eSopenharmony_ci /** 124761847f8eSopenharmony_ci * The uid of this tag, it. 124861847f8eSopenharmony_ci * 124961847f8eSopenharmony_ci * @permission ohos.permission.NFC_TAG 125061847f8eSopenharmony_ci * @type { number[] } 125161847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 125261847f8eSopenharmony_ci * @atomicservice 125361847f8eSopenharmony_ci * @since 12 125461847f8eSopenharmony_ci */ 125561847f8eSopenharmony_ci uid: number[]; 125661847f8eSopenharmony_ci 125761847f8eSopenharmony_ci /** 125861847f8eSopenharmony_ci * The supported technology list of this tag. 125961847f8eSopenharmony_ci * 126061847f8eSopenharmony_ci * @permission ohos.permission.NFC_TAG 126161847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 126261847f8eSopenharmony_ci * @since 9 126361847f8eSopenharmony_ci */ 126461847f8eSopenharmony_ci /** 126561847f8eSopenharmony_ci * The supported technology list of this tag. 126661847f8eSopenharmony_ci * 126761847f8eSopenharmony_ci * @permission ohos.permission.NFC_TAG 126861847f8eSopenharmony_ci * @type { number[] } 126961847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 127061847f8eSopenharmony_ci * @atomicservice 127161847f8eSopenharmony_ci * @since 12 127261847f8eSopenharmony_ci */ 127361847f8eSopenharmony_ci technology: number[]; 127461847f8eSopenharmony_ci 127561847f8eSopenharmony_ci /** 127661847f8eSopenharmony_ci * The extra data for each technology of this tag. 127761847f8eSopenharmony_ci * 127861847f8eSopenharmony_ci * @permission ohos.permission.NFC_TAG 127961847f8eSopenharmony_ci * @type { PacMap[] } 128061847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 128161847f8eSopenharmony_ci * @systemapi hide for inner use. 128261847f8eSopenharmony_ci * @since 9 128361847f8eSopenharmony_ci */ 128461847f8eSopenharmony_ci extrasData: PacMap[]; 128561847f8eSopenharmony_ci 128661847f8eSopenharmony_ci /** 128761847f8eSopenharmony_ci * The the RF discovery id of this tag. 128861847f8eSopenharmony_ci * 128961847f8eSopenharmony_ci * @permission ohos.permission.NFC_TAG 129061847f8eSopenharmony_ci * @type { number } 129161847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 129261847f8eSopenharmony_ci * @systemapi hide for inner use. 129361847f8eSopenharmony_ci * @since 9 129461847f8eSopenharmony_ci */ 129561847f8eSopenharmony_ci tagRfDiscId: number; 129661847f8eSopenharmony_ci 129761847f8eSopenharmony_ci /** 129861847f8eSopenharmony_ci * The extra data for the technology of this tag. 129961847f8eSopenharmony_ci * 130061847f8eSopenharmony_ci * @permission ohos.permission.NFC_TAG 130161847f8eSopenharmony_ci * @type { rpc.RemoteObject } 130261847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 130361847f8eSopenharmony_ci * @systemapi hide for inner use. 130461847f8eSopenharmony_ci * @since 9 130561847f8eSopenharmony_ci */ 130661847f8eSopenharmony_ci remoteTagService: rpc.RemoteObject; 130761847f8eSopenharmony_ci 130861847f8eSopenharmony_ci /** 130961847f8eSopenharmony_ci * The supported technology list of this tag. 131061847f8eSopenharmony_ci * 131161847f8eSopenharmony_ci * @permission ohos.permission.NFC_TAG 131261847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 131361847f8eSopenharmony_ci * @since 7 131461847f8eSopenharmony_ci * @deprecated since 9 131561847f8eSopenharmony_ci * @useinstead ohos.nfc.tag/tag.TagInfo#technology 131661847f8eSopenharmony_ci */ 131761847f8eSopenharmony_ci supportedProfiles: number[]; 131861847f8eSopenharmony_ci } 131961847f8eSopenharmony_ci 132061847f8eSopenharmony_ci /** 132161847f8eSopenharmony_ci * NDEF records definition, see NFCForum-TS-NDEF_1.0. 132261847f8eSopenharmony_ci * 132361847f8eSopenharmony_ci * @typedef NdefRecord 132461847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 132561847f8eSopenharmony_ci * @since 9 132661847f8eSopenharmony_ci */ 132761847f8eSopenharmony_ci /** 132861847f8eSopenharmony_ci * NDEF records definition, see NFCForum-TS-NDEF_1.0. 132961847f8eSopenharmony_ci * 133061847f8eSopenharmony_ci * @typedef NdefRecord 133161847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 133261847f8eSopenharmony_ci * @atomicservice 133361847f8eSopenharmony_ci * @since 12 133461847f8eSopenharmony_ci */ 133561847f8eSopenharmony_ci export interface NdefRecord { 133661847f8eSopenharmony_ci /** 133761847f8eSopenharmony_ci * tnf of NdefRecord 133861847f8eSopenharmony_ci * 133961847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 134061847f8eSopenharmony_ci * @since 9 134161847f8eSopenharmony_ci */ 134261847f8eSopenharmony_ci /** 134361847f8eSopenharmony_ci * tnf of NdefRecord 134461847f8eSopenharmony_ci * 134561847f8eSopenharmony_ci * @type { number } 134661847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 134761847f8eSopenharmony_ci * @atomicservice 134861847f8eSopenharmony_ci * @since 12 134961847f8eSopenharmony_ci */ 135061847f8eSopenharmony_ci tnf: number; 135161847f8eSopenharmony_ci 135261847f8eSopenharmony_ci /** 135361847f8eSopenharmony_ci * RTD type of NdefRecord 135461847f8eSopenharmony_ci * 135561847f8eSopenharmony_ci * @type { number[] } 135661847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 135761847f8eSopenharmony_ci * @since 9 135861847f8eSopenharmony_ci */ 135961847f8eSopenharmony_ci /** 136061847f8eSopenharmony_ci * RTD type of NdefRecord 136161847f8eSopenharmony_ci * 136261847f8eSopenharmony_ci * @type { number[] } 136361847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 136461847f8eSopenharmony_ci * @atomicservice 136561847f8eSopenharmony_ci * @since 12 136661847f8eSopenharmony_ci */ 136761847f8eSopenharmony_ci rtdType: number[]; 136861847f8eSopenharmony_ci 136961847f8eSopenharmony_ci /** 137061847f8eSopenharmony_ci * id of NdefRecord 137161847f8eSopenharmony_ci * 137261847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 137361847f8eSopenharmony_ci * @since 9 137461847f8eSopenharmony_ci */ 137561847f8eSopenharmony_ci /** 137661847f8eSopenharmony_ci * id of NdefRecord 137761847f8eSopenharmony_ci * 137861847f8eSopenharmony_ci * @type { number[] } 137961847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 138061847f8eSopenharmony_ci * @atomicservice 138161847f8eSopenharmony_ci * @since 12 138261847f8eSopenharmony_ci */ 138361847f8eSopenharmony_ci id: number[]; 138461847f8eSopenharmony_ci 138561847f8eSopenharmony_ci /** 138661847f8eSopenharmony_ci * payload of NdefRecord 138761847f8eSopenharmony_ci * 138861847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 138961847f8eSopenharmony_ci * @since 9 139061847f8eSopenharmony_ci */ 139161847f8eSopenharmony_ci /** 139261847f8eSopenharmony_ci * payload of NdefRecord 139361847f8eSopenharmony_ci * 139461847f8eSopenharmony_ci * @type { number[] } 139561847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 139661847f8eSopenharmony_ci * @atomicservice 139761847f8eSopenharmony_ci * @since 12 139861847f8eSopenharmony_ci */ 139961847f8eSopenharmony_ci payload: number[]; 140061847f8eSopenharmony_ci } 140161847f8eSopenharmony_ci 140261847f8eSopenharmony_ci /** 140361847f8eSopenharmony_ci * Provides methods for accessing NDEF tag. 140461847f8eSopenharmony_ci * 140561847f8eSopenharmony_ci * @namespace ndef 140661847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 140761847f8eSopenharmony_ci * @since 9 140861847f8eSopenharmony_ci */ 140961847f8eSopenharmony_ci /** 141061847f8eSopenharmony_ci * Provides methods for accessing NDEF tag. 141161847f8eSopenharmony_ci * 141261847f8eSopenharmony_ci * @namespace ndef 141361847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 141461847f8eSopenharmony_ci * @atomicservice 141561847f8eSopenharmony_ci * @since 12 141661847f8eSopenharmony_ci */ 141761847f8eSopenharmony_ci namespace ndef { 141861847f8eSopenharmony_ci /** 141961847f8eSopenharmony_ci * Creates an NDEF record with uri data. 142061847f8eSopenharmony_ci * 142161847f8eSopenharmony_ci * @param { string } uri - Uri data for new NDEF record. 142261847f8eSopenharmony_ci * @returns { NdefRecord } The instance of NdefRecord. 142361847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 142461847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 142561847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 142661847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 142761847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 142861847f8eSopenharmony_ci * @since 9 142961847f8eSopenharmony_ci */ 143061847f8eSopenharmony_ci /** 143161847f8eSopenharmony_ci * Creates an NDEF record with uri data. 143261847f8eSopenharmony_ci * 143361847f8eSopenharmony_ci * @param { string } uri - Uri data for new NDEF record. 143461847f8eSopenharmony_ci * @returns { NdefRecord } The instance of NdefRecord. 143561847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 143661847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 143761847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 143861847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 143961847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 144061847f8eSopenharmony_ci * @atomicservice 144161847f8eSopenharmony_ci * @since 12 144261847f8eSopenharmony_ci */ 144361847f8eSopenharmony_ci function makeUriRecord(uri: string): NdefRecord; 144461847f8eSopenharmony_ci 144561847f8eSopenharmony_ci /** 144661847f8eSopenharmony_ci * Creates an NDEF record with text data. 144761847f8eSopenharmony_ci * 144861847f8eSopenharmony_ci * @param { string } text - Text data for new an NDEF record. 144961847f8eSopenharmony_ci * @param { string } locale - Language code for the NDEF record. if locale is null, use default locale. 145061847f8eSopenharmony_ci * @returns { NdefRecord } The instance of NdefRecord. 145161847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 145261847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 145361847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 145461847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 145561847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 145661847f8eSopenharmony_ci * @since 9 145761847f8eSopenharmony_ci */ 145861847f8eSopenharmony_ci /** 145961847f8eSopenharmony_ci * Creates an NDEF record with text data. 146061847f8eSopenharmony_ci * 146161847f8eSopenharmony_ci * @param { string } text - Text data for new an NDEF record. 146261847f8eSopenharmony_ci * @param { string } locale - Language code for the NDEF record. if locale is null, use default locale. 146361847f8eSopenharmony_ci * @returns { NdefRecord } The instance of NdefRecord. 146461847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 146561847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 146661847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 146761847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 146861847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 146961847f8eSopenharmony_ci * @atomicservice 147061847f8eSopenharmony_ci * @since 12 147161847f8eSopenharmony_ci */ 147261847f8eSopenharmony_ci function makeTextRecord(text: string, locale: string): NdefRecord; 147361847f8eSopenharmony_ci 147461847f8eSopenharmony_ci /** 147561847f8eSopenharmony_ci * Creates an NDEF record with mime data. 147661847f8eSopenharmony_ci * 147761847f8eSopenharmony_ci * @param { string } mimeType type of mime data for new an NDEF record. 147861847f8eSopenharmony_ci * @param { number[] } mimeData mime data for new an NDEF record. 147961847f8eSopenharmony_ci * @returns { NdefRecord } The instance of NdefRecord. 148061847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 148161847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 148261847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 148361847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 148461847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 148561847f8eSopenharmony_ci * @since 9 148661847f8eSopenharmony_ci */ 148761847f8eSopenharmony_ci /** 148861847f8eSopenharmony_ci * Creates an NDEF record with mime data. 148961847f8eSopenharmony_ci * 149061847f8eSopenharmony_ci * @param { string } mimeType type of mime data for new an NDEF record. 149161847f8eSopenharmony_ci * @param { number[] } mimeData mime data for new an NDEF record. 149261847f8eSopenharmony_ci * @returns { NdefRecord } The instance of NdefRecord. 149361847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 149461847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 149561847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 149661847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 149761847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 149861847f8eSopenharmony_ci * @atomicservice 149961847f8eSopenharmony_ci * @since 12 150061847f8eSopenharmony_ci */ 150161847f8eSopenharmony_ci function makeMimeRecord(mimeType: string, mimeData: number[]): NdefRecord; 150261847f8eSopenharmony_ci 150361847f8eSopenharmony_ci /** 150461847f8eSopenharmony_ci * Creates an NDEF record with external data. 150561847f8eSopenharmony_ci * 150661847f8eSopenharmony_ci * @param { string } domainName - Domain name of issuing organization for the external data. 150761847f8eSopenharmony_ci * @param { string } type - Domain specific type of data for the external data. 150861847f8eSopenharmony_ci * @param { number[] } externalData - Data payload of an NDEF record. 150961847f8eSopenharmony_ci * @returns { NdefRecord } The instance of NdefRecord. 151061847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 151161847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 151261847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 151361847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 151461847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 151561847f8eSopenharmony_ci * @since 9 151661847f8eSopenharmony_ci */ 151761847f8eSopenharmony_ci /** 151861847f8eSopenharmony_ci * Creates an NDEF record with external data. 151961847f8eSopenharmony_ci * 152061847f8eSopenharmony_ci * @param { string } domainName - Domain name of issuing organization for the external data. 152161847f8eSopenharmony_ci * @param { string } type - Domain specific type of data for the external data. 152261847f8eSopenharmony_ci * @param { number[] } externalData - Data payload of an NDEF record. 152361847f8eSopenharmony_ci * @returns { NdefRecord } The instance of NdefRecord. 152461847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 152561847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 152661847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 152761847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 152861847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 152961847f8eSopenharmony_ci * @atomicservice 153061847f8eSopenharmony_ci * @since 12 153161847f8eSopenharmony_ci */ 153261847f8eSopenharmony_ci function makeExternalRecord(domainName: string, type: string, externalData: number[]): NdefRecord; 153361847f8eSopenharmony_ci /** 153461847f8eSopenharmony_ci * Creates an NDEF message with raw bytes. 153561847f8eSopenharmony_ci * 153661847f8eSopenharmony_ci * @param { number[] } data - The raw bytes to parse NDEF message. 153761847f8eSopenharmony_ci * @returns { NdefMessage } The instance of NdefMessage. 153861847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 153961847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 154061847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 154161847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 154261847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 154361847f8eSopenharmony_ci * @since 9 154461847f8eSopenharmony_ci */ 154561847f8eSopenharmony_ci /** 154661847f8eSopenharmony_ci * Creates an NDEF message with raw bytes. 154761847f8eSopenharmony_ci * 154861847f8eSopenharmony_ci * @param { number[] } data - The raw bytes to parse NDEF message. 154961847f8eSopenharmony_ci * @returns { NdefMessage } The instance of NdefMessage. 155061847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 155161847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 155261847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 155361847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 155461847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 155561847f8eSopenharmony_ci * @atomicservice 155661847f8eSopenharmony_ci * @since 12 155761847f8eSopenharmony_ci */ 155861847f8eSopenharmony_ci function createNdefMessage(data: number[]): NdefMessage; 155961847f8eSopenharmony_ci 156061847f8eSopenharmony_ci /** 156161847f8eSopenharmony_ci * Creates an NDEF message with record list. 156261847f8eSopenharmony_ci * 156361847f8eSopenharmony_ci * @param { NdefRecord[] } ndefRecords - The NDEF records to parse NDEF message. 156461847f8eSopenharmony_ci * @returns { NdefMessage } The instance of NdefMessage. 156561847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 156661847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 156761847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 156861847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 156961847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 157061847f8eSopenharmony_ci * @since 9 157161847f8eSopenharmony_ci */ 157261847f8eSopenharmony_ci /** 157361847f8eSopenharmony_ci * Creates an NDEF message with record list. 157461847f8eSopenharmony_ci * 157561847f8eSopenharmony_ci * @param { NdefRecord[] } ndefRecords - The NDEF records to parse NDEF message. 157661847f8eSopenharmony_ci * @returns { NdefMessage } The instance of NdefMessage. 157761847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 157861847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 157961847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 158061847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 158161847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 158261847f8eSopenharmony_ci * @atomicservice 158361847f8eSopenharmony_ci * @since 12 158461847f8eSopenharmony_ci */ 158561847f8eSopenharmony_ci function createNdefMessage(ndefRecords: NdefRecord[]): NdefMessage; 158661847f8eSopenharmony_ci 158761847f8eSopenharmony_ci /** 158861847f8eSopenharmony_ci * Parses an NDEF message into raw bytes. 158961847f8eSopenharmony_ci * 159061847f8eSopenharmony_ci * @param { NdefMessage } ndefMessage - An NDEF message to parse. 159161847f8eSopenharmony_ci * @returns { number[] } Returns the raw bytes of an NDEF message. 159261847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. 159361847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 159461847f8eSopenharmony_ci * @since 9 159561847f8eSopenharmony_ci */ 159661847f8eSopenharmony_ci /** 159761847f8eSopenharmony_ci * Parses an NDEF message into raw bytes. 159861847f8eSopenharmony_ci * 159961847f8eSopenharmony_ci * @param { NdefMessage } ndefMessage - An NDEF message to parse. 160061847f8eSopenharmony_ci * @returns { number[] } Returns the raw bytes of an NDEF message. 160161847f8eSopenharmony_ci * @throws { BusinessError } 401 - The parameter check failed. Possible causes: 160261847f8eSopenharmony_ci * <br> 1. Mandatory parameters are left unspecified. 160361847f8eSopenharmony_ci * <br> 2. Incorrect parameters types. 160461847f8eSopenharmony_ci * <br> 3. Parameter verification failed. 160561847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 160661847f8eSopenharmony_ci * @atomicservice 160761847f8eSopenharmony_ci * @since 12 160861847f8eSopenharmony_ci */ 160961847f8eSopenharmony_ci function messageToBytes(ndefMessage: NdefMessage): number[]; 161061847f8eSopenharmony_ci } 161161847f8eSopenharmony_ci 161261847f8eSopenharmony_ci /** 161361847f8eSopenharmony_ci * Exports type NfcATag. 161461847f8eSopenharmony_ci * 161561847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 161661847f8eSopenharmony_ci * @since 7 161761847f8eSopenharmony_ci */ 161861847f8eSopenharmony_ci /** 161961847f8eSopenharmony_ci * Exports type NfcATag. 162061847f8eSopenharmony_ci * 162161847f8eSopenharmony_ci * @typedef { _NfcATag } 162261847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 162361847f8eSopenharmony_ci * @atomicservice 162461847f8eSopenharmony_ci * @since 12 162561847f8eSopenharmony_ci */ 162661847f8eSopenharmony_ci export type NfcATag = _NfcATag; 162761847f8eSopenharmony_ci 162861847f8eSopenharmony_ci /** 162961847f8eSopenharmony_ci * Exports type NfcBTag. 163061847f8eSopenharmony_ci * 163161847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 163261847f8eSopenharmony_ci * @since 7 163361847f8eSopenharmony_ci */ 163461847f8eSopenharmony_ci /** 163561847f8eSopenharmony_ci * Exports type NfcBTag. 163661847f8eSopenharmony_ci * 163761847f8eSopenharmony_ci * @typedef { _NfcBTag } 163861847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 163961847f8eSopenharmony_ci * @atomicservice 164061847f8eSopenharmony_ci * @since 12 164161847f8eSopenharmony_ci */ 164261847f8eSopenharmony_ci export type NfcBTag = _NfcBTag; 164361847f8eSopenharmony_ci 164461847f8eSopenharmony_ci /** 164561847f8eSopenharmony_ci * Exports type NfcFTag. 164661847f8eSopenharmony_ci * 164761847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 164861847f8eSopenharmony_ci * @since 7 164961847f8eSopenharmony_ci */ 165061847f8eSopenharmony_ci /** 165161847f8eSopenharmony_ci * Exports type NfcFTag. 165261847f8eSopenharmony_ci * 165361847f8eSopenharmony_ci * @typedef { _NfcFTag } 165461847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 165561847f8eSopenharmony_ci * @atomicservice 165661847f8eSopenharmony_ci * @since 12 165761847f8eSopenharmony_ci */ 165861847f8eSopenharmony_ci export type NfcFTag = _NfcFTag; 165961847f8eSopenharmony_ci 166061847f8eSopenharmony_ci /** 166161847f8eSopenharmony_ci * Exports type NfcVTag. 166261847f8eSopenharmony_ci * 166361847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 166461847f8eSopenharmony_ci * @since 7 166561847f8eSopenharmony_ci */ 166661847f8eSopenharmony_ci /** 166761847f8eSopenharmony_ci * Exports type NfcVTag. 166861847f8eSopenharmony_ci * 166961847f8eSopenharmony_ci * @typedef { _NfcVTag } 167061847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 167161847f8eSopenharmony_ci * @atomicservice 167261847f8eSopenharmony_ci * @since 12 167361847f8eSopenharmony_ci */ 167461847f8eSopenharmony_ci export type NfcVTag = _NfcVTag; 167561847f8eSopenharmony_ci 167661847f8eSopenharmony_ci /** 167761847f8eSopenharmony_ci * Exports type IsoDepTag. 167861847f8eSopenharmony_ci * 167961847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 168061847f8eSopenharmony_ci * @since 9 168161847f8eSopenharmony_ci */ 168261847f8eSopenharmony_ci /** 168361847f8eSopenharmony_ci * Exports type IsoDepTag. 168461847f8eSopenharmony_ci * 168561847f8eSopenharmony_ci * @typedef { _IsoDepTag } 168661847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 168761847f8eSopenharmony_ci * @atomicservice 168861847f8eSopenharmony_ci * @since 12 168961847f8eSopenharmony_ci */ 169061847f8eSopenharmony_ci export type IsoDepTag = _IsoDepTag; 169161847f8eSopenharmony_ci 169261847f8eSopenharmony_ci /** 169361847f8eSopenharmony_ci * Exports type NdefTag. 169461847f8eSopenharmony_ci * 169561847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 169661847f8eSopenharmony_ci * @since 9 169761847f8eSopenharmony_ci */ 169861847f8eSopenharmony_ci /** 169961847f8eSopenharmony_ci * Exports type NdefTag. 170061847f8eSopenharmony_ci * 170161847f8eSopenharmony_ci * @typedef { _NdefTag } 170261847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 170361847f8eSopenharmony_ci * @atomicservice 170461847f8eSopenharmony_ci * @since 12 170561847f8eSopenharmony_ci */ 170661847f8eSopenharmony_ci export type NdefTag = _NdefTag; 170761847f8eSopenharmony_ci 170861847f8eSopenharmony_ci /** 170961847f8eSopenharmony_ci * Exports type MifareClassicTag. 171061847f8eSopenharmony_ci * 171161847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 171261847f8eSopenharmony_ci * @since 9 171361847f8eSopenharmony_ci */ 171461847f8eSopenharmony_ci /** 171561847f8eSopenharmony_ci * Exports type MifareClassicTag. 171661847f8eSopenharmony_ci * 171761847f8eSopenharmony_ci * @typedef { _MifareClassicTag } 171861847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 171961847f8eSopenharmony_ci * @atomicservice 172061847f8eSopenharmony_ci * @since 12 172161847f8eSopenharmony_ci */ 172261847f8eSopenharmony_ci export type MifareClassicTag = _MifareClassicTag; 172361847f8eSopenharmony_ci 172461847f8eSopenharmony_ci /** 172561847f8eSopenharmony_ci * Exports type MifareUltralightTag. 172661847f8eSopenharmony_ci * 172761847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 172861847f8eSopenharmony_ci * @since 9 172961847f8eSopenharmony_ci */ 173061847f8eSopenharmony_ci /** 173161847f8eSopenharmony_ci * Exports type MifareUltralightTag. 173261847f8eSopenharmony_ci * 173361847f8eSopenharmony_ci * @typedef { _MifareUltralightTag } 173461847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 173561847f8eSopenharmony_ci * @atomicservice 173661847f8eSopenharmony_ci * @since 12 173761847f8eSopenharmony_ci */ 173861847f8eSopenharmony_ci export type MifareUltralightTag = _MifareUltralightTag; 173961847f8eSopenharmony_ci 174061847f8eSopenharmony_ci /** 174161847f8eSopenharmony_ci * Exports type NdefFormatableTag. 174261847f8eSopenharmony_ci * 174361847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 174461847f8eSopenharmony_ci * @since 9 174561847f8eSopenharmony_ci */ 174661847f8eSopenharmony_ci /** 174761847f8eSopenharmony_ci * Exports type NdefFormatableTag. 174861847f8eSopenharmony_ci * 174961847f8eSopenharmony_ci * @typedef { _NdefFormatableTag } 175061847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 175161847f8eSopenharmony_ci * @atomicservice 175261847f8eSopenharmony_ci * @since 12 175361847f8eSopenharmony_ci */ 175461847f8eSopenharmony_ci export type NdefFormatableTag = _NdefFormatableTag; 175561847f8eSopenharmony_ci 175661847f8eSopenharmony_ci /** 175761847f8eSopenharmony_ci * Exports type NdefMessage. 175861847f8eSopenharmony_ci * 175961847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 176061847f8eSopenharmony_ci * @since 9 176161847f8eSopenharmony_ci */ 176261847f8eSopenharmony_ci /** 176361847f8eSopenharmony_ci * Exports type NdefMessage. 176461847f8eSopenharmony_ci * 176561847f8eSopenharmony_ci * @typedef { _NdefMessage } 176661847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 176761847f8eSopenharmony_ci * @atomicservice 176861847f8eSopenharmony_ci * @since 12 176961847f8eSopenharmony_ci */ 177061847f8eSopenharmony_ci export type NdefMessage = _NdefMessage; 177161847f8eSopenharmony_ci 177261847f8eSopenharmony_ci /** 177361847f8eSopenharmony_ci * Exports type TagSession. 177461847f8eSopenharmony_ci * 177561847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 177661847f8eSopenharmony_ci * @since 7 177761847f8eSopenharmony_ci */ 177861847f8eSopenharmony_ci /** 177961847f8eSopenharmony_ci * Exports type TagSession. 178061847f8eSopenharmony_ci * 178161847f8eSopenharmony_ci * @typedef { _TagSession } 178261847f8eSopenharmony_ci * @syscap SystemCapability.Communication.NFC.Tag 178361847f8eSopenharmony_ci * @atomicservice 178461847f8eSopenharmony_ci * @since 12 178561847f8eSopenharmony_ci */ 178661847f8eSopenharmony_ci export type TagSession = _TagSession; 178761847f8eSopenharmony_ci} 178861847f8eSopenharmony_ciexport default tag;