1 Star 0 Fork 3.9K

Feng Lin/interface_sdk-js

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
文件
克隆/下载
@ohos.telephony.radio.d.ts 125.53 KB
一键复制 编辑 原始数据 按行查看 历史
dingxiaochen 提交于 9个月前 . fix js doc
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327332833293330333133323333333433353336333733383339334033413342334333443345334633473348334933503351335233533354335533563357335833593360336133623363336433653366336733683369337033713372337333743375337633773378337933803381338233833384338533863387338833893390339133923393
/*
* Copyright (C) 2021-2024 Huawei Device Co., Ltd.
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* @file
* @kit TelephonyKit
*/
import type { AsyncCallback, Callback } from './@ohos.base';
/**
* Provides interfaces for applications to obtain the network state, cell information, signal information,
* and device ID of the wireless cellular network (WCN), and provides a callback registration mechanism to
* listen for changes of the network, cell, and signal status of the WCN.
*
* @namespace radio
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
declare namespace radio {
/**
* Obtains radio access technology (RAT) of the registered network. The system
* returns RAT of the packet service (PS) and circuit service (CS) domain.
*
* @permission ohos.permission.GET_NETWORK_INFO
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slot index number supported by the device.
* @param { AsyncCallback<{psRadioTech: RadioTechnology, csRadioTech: RadioTechnology}> } callback - Returns
* an integer indicating the RAT in use. The values are as follows:
* <ul>
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_UNKNOWN}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_GSM}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_1XRTT}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_WCDMA}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_HSPA}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_HSPAP}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_TD_SCDMA}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_EVDO}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_EHRPD}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_LTE}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_LTE_CA}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_IWLAN}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_NR}
* </ul>
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 401 - Parameter error.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
/**
* Obtains radio access technology (RAT) of the registered network. The system
* returns RAT of the packet service (PS) and circuit service (CS) domain.
*
* @permission ohos.permission.GET_NETWORK_INFO
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slot index number supported by the device.
* @param { AsyncCallback<NetworkRadioTech> } callback - Returns
* the RAT of PS domain and CS domain of registered network.
* The values of RAT are as follows:
* <ul>
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_UNKNOWN}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_GSM}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_1XRTT}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_WCDMA}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_HSPA}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_HSPAP}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_TD_SCDMA}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_EVDO}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_EHRPD}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_LTE}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_LTE_CA}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_IWLAN}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_NR}
* </ul>
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @since 11
*/
function getRadioTech(slotId: number, callback: AsyncCallback<NetworkRadioTech>): void;
/**
* Obtains radio access technology (RAT) of the registered network. The system
* returns RAT of the packet service (PS) and circuit service (CS) domain.
*
* @permission ohos.permission.GET_NETWORK_INFO
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slot index number supported by the device.
* @returns { Promise<{psRadioTech: RadioTechnology, csRadioTech: RadioTechnology}> } Returns
* the enumeration of RadioTechnology. The values are as follows:
* <ul>
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_UNKNOWN}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_GSM}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_1XRTT}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_WCDMA}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_HSPA}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_HSPAP}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_TD_SCDMA}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_EVDO}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_EHRPD}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_LTE}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_LTE_CA}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_IWLAN}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_NR}
* </ul>
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 401 - Parameter error.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
/**
* Obtains radio access technology (RAT) of the registered network. The system
* returns RAT of the packet service (PS) and circuit service (CS) domain.
*
* @permission ohos.permission.GET_NETWORK_INFO
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slot index number supported by the device.
* @returns { Promise<NetworkRadioTech> } Returns the RAT of PS domain and CS domain of registered network.
* The values of RAT are as follows:
* <ul>
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_UNKNOWN}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_GSM}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_1XRTT}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_WCDMA}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_HSPA}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_HSPAP}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_TD_SCDMA}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_EVDO}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_EHRPD}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_LTE}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_LTE_CA}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_IWLAN}
* <li>{@code RadioTechnology#RADIO_TECHNOLOGY_NR}
* </ul>
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @since 11
*/
function getRadioTech(slotId: number): Promise<NetworkRadioTech>;
/**
* Obtains the network state of the registered network.
*
* @permission ohos.permission.GET_NETWORK_INFO
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slot index number supported by the device.
* @param { AsyncCallback<NetworkState> } callback - Indicates the callback for getting network registration state.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
function getNetworkState(slotId: number, callback: AsyncCallback<NetworkState>): void;
/**
* Obtains the network state of the registered network.
*
* @permission ohos.permission.GET_NETWORK_INFO
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slot index number supported by the device.
* @returns { Promise<NetworkState> } Returns the NetworkState object.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
function getNetworkState(slotId?: number): Promise<NetworkState>;
/**
* Obtains the network state of the registered network.
*
* @permission ohos.permission.GET_NETWORK_INFO
* @param { AsyncCallback<NetworkState> } callback - Indicates the callback for getting network registration state.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
function getNetworkState(callback: AsyncCallback<NetworkState>): void;
/**
* Actively requests to update location information.
*
* @permission ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot
* index number supported by the device.
* @param { AsyncCallback<void> } callback - The callback of sendUpdateCellLocationRequest.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
function sendUpdateCellLocationRequest(slotId: number, callback: AsyncCallback<void>): void;
/**
* Actively requests to update location information.
*
* @permission ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot
* index number supported by the device.
* @returns { Promise<void> } The promise returned by the sendUpdateCellLocationRequest.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
function sendUpdateCellLocationRequest(slotId?: number): Promise<void>;
/**
* Actively requests to update location information.
*
* @permission ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION
* @param { AsyncCallback<void> } callback - The callback of sendUpdateCellLocationRequest.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
function sendUpdateCellLocationRequest(callback: AsyncCallback<void>): void;
/**
* Get the current cell information.
*
* @permission ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot
* index number supported by the device.
* @param { AsyncCallback<Array<CellInformation>> } callback - Indicates the callback for getting cell information.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
function getCellInformation(slotId: number, callback: AsyncCallback<Array<CellInformation>>): void;
/**
* Get the current cell information.
*
* @permission ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot
* index number supported by the device.
* @returns { Promise<Array<CellInformation>> } Returns the current cell information.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
function getCellInformation(slotId?: number): Promise<Array<CellInformation>>;
/**
* Get the current cell information.
*
* @permission ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION
* @param { AsyncCallback<Array<CellInformation>> } callback - Indicates the callback for getting cell information.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
function getCellInformation(callback: AsyncCallback<Array<CellInformation>>): void;
/**
* Obtains the network search mode of the SIM card in a specified slot.
*
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot
* index number supported by the device.
* @param { AsyncCallback<NetworkSelectionMode> } callback - Indicates the callback for getting
* the network search mode of the SIM card. Available values are as follows:
* <ul>
* <li>{@link NetworkSelectionMode#NETWORK_SELECTION_UNKNOWN}
* <li>{@link NetworkSelectionMode#NETWORK_SELECTION_AUTOMATIC}
* <li>{@link NetworkSelectionMode#NETWORK_SELECTION_MANUAL}
* <ul>
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
function getNetworkSelectionMode(slotId: number, callback: AsyncCallback<NetworkSelectionMode>): void;
/**
* Obtains the network search mode of the SIM card in a specified slot.
*
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot
* index number supported by the device.
* @returns { Promise<NetworkSelectionMode> } Returns the network search mode of the SIM card.
* Available values are as follows:
* <ul>
* <li>{@link NetworkSelectionMode#NETWORK_SELECTION_UNKNOWN}
* <li>{@link NetworkSelectionMode#NETWORK_SELECTION_AUTOMATIC}
* <li>{@link NetworkSelectionMode#NETWORK_SELECTION_MANUAL}
* <ul>
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
function getNetworkSelectionMode(slotId: number): Promise<NetworkSelectionMode>;
/**
* Set the current network selection mode.
*
* @permission ohos.permission.SET_TELEPHONY_STATE
* @param { NetworkSelectionModeOptions } options Indicates the network selection mode option.
* @param { AsyncCallback<void> } callback - The callback of setNetworkSelectionMode.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 6
*/
function setNetworkSelectionMode(options: NetworkSelectionModeOptions, callback: AsyncCallback<void>): void;
/**
* Set the current network selection mode.
*
* @permission ohos.permission.SET_TELEPHONY_STATE
* @param { NetworkSelectionModeOptions } options Indicates the network selection mode option.
* @returns { Promise<void> } The promise returned by the setNetworkSelectionMode.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 6
*/
function setNetworkSelectionMode(options: NetworkSelectionModeOptions): Promise<void>;
/**
* Get network search information.
*
* @permission ohos.permission.GET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot
* index number supported by the device.
* @param { AsyncCallback<NetworkSearchResult> } callback - Indicates the callback for getting
* the search results of the network.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 6
*/
function getNetworkSearchInformation(slotId: number, callback: AsyncCallback<NetworkSearchResult>): void;
/**
* Get network search information.
*
* @permission ohos.permission.GET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot
* index number supported by the device.
* @returns { Promise<NetworkSearchResult> } Returns the search results of the network.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 6
*/
function getNetworkSearchInformation(slotId: number): Promise<NetworkSearchResult>;
/**
* Obtains the ISO-defined country code of the country where the registered network is deployed.
*
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slot index number supported by the device.
* @param { AsyncCallback<string> } callback - Indicates the callback for getting the country code
* defined in ISO 3166-2; returns an empty string if the device is not registered with any network.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @since 7
*/
function getISOCountryCodeForNetwork(slotId: number, callback: AsyncCallback<string>): void;
/**
* Obtains the ISO-defined country code of the country where the registered network is deployed.
*
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slot index number supported by the device.
* @returns { Promise<string> } Returns the country code defined in ISO 3166-2.
* Returns an empty string if the device is not registered with any network.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @since 7
*/
function getISOCountryCodeForNetwork(slotId: number): Promise<string>;
/**
* Obtains the ISO-defined country code of the country where the registered network is deployed.
*
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slots supported by the device.
* @returns { string } Returns the country code defined in ISO 3166-2.
* Returns an empty string if the device is not registered with any network.
* @syscap SystemCapability.Telephony.CoreService
* @since 10
*/
function getISOCountryCodeForNetworkSync(slotId: number): string;
/**
* Get the option mode of NR.
*
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot
* index number supported by the device.
* @param { AsyncCallback<NrOptionMode> } callback - Indicates the callback for getting the selection mode of NR.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
* @deprecated since 10
* @useinstead telephony.radio#getNROptionMode
*/
function getNrOptionMode(slotId: number, callback: AsyncCallback<NrOptionMode>): void;
/**
* Get the option mode of NR.
*
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot
* index number supported by the device.
* @returns { Promise<NrOptionMode> } Returns the selection mode of NR.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
* @deprecated since 10
* @useinstead telephony.radio#getNROptionMode
*/
function getNrOptionMode(slotId?: number): Promise<NrOptionMode>;
/**
* Get the option mode of NR.
*
* @param { AsyncCallback<NrOptionMode> } callback - Indicates the callback for getting the selection mode of NR.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
* @deprecated since 10
* @useinstead telephony.radio#getNROptionMode
*/
function getNrOptionMode(callback: AsyncCallback<NrOptionMode>): void;
/**
* Obtains the IMEI of a specified card slot of the device.
*
* @permission ohos.permission.GET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot
* index number supported by the device.
* @param { AsyncCallback<string> } callback - Indicates the callback for getting the IMEI.
* Returns an empty string if the IMEI does not exist.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
function getIMEI(slotId: number, callback: AsyncCallback<string>): void;
/**
* Obtains the IMEI of a specified card slot of the device.
*
* @permission ohos.permission.GET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot
* index number supported by the device.
* @returns { Promise<string> } Returns the IMEI. Returns an empty string if the IMEI does not exist.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
function getIMEI(slotId?: number): Promise<string>;
/**
* Obtains the IMEI of a specified card slot of the device.
*
* @permission ohos.permission.GET_TELEPHONY_STATE
* @param { AsyncCallback<string> } callback - Indicates the callback for getting the IMEI.
* Returns an empty string if the IMEI does not exist.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
function getIMEI(callback: AsyncCallback<string>): void;
/**
* Obtains the MEID of a specified card slot of the device.
*
* @permission ohos.permission.GET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot
* index number supported by the device.
* @param { AsyncCallback<string> } callback - Indicates the callback for getting the MEID.
* Returns an empty string if the MEID does not exist.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
function getMEID(slotId: number, callback: AsyncCallback<string>): void;
/**
* Obtains the MEID of a specified card slot of the device.
*
* @permission ohos.permission.GET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot
* index number supported by the device.
* @returns { Promise<string> } Returns the MEID. Returns an empty string if the MEID does not exist.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
function getMEID(slotId?: number): Promise<string>;
/**
* Obtains the MEID of a specified card slot of the device.
*
* @permission ohos.permission.GET_TELEPHONY_STATE
* @param { AsyncCallback<string> } callback - Indicates the callback for getting the MEID.
* Returns an empty string if the MEID does not exist.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
function getMEID(callback: AsyncCallback<string>): void;
/**
* Obtains the unique device ID of a specified card slot of the device.
*
* If the device is registered with a 3GPP-compliant network, the international mobile equipment identity
* (IMEI) is returned. If the device is registered with a 3GPP2-compliant network, the mobile equipment identifier
* (MEID) is returned.
*
* @permission ohos.permission.GET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot
* index number supported by the device.
* @param { AsyncCallback<string> } callback - Indicates the callback for getting the unique device ID.
* Returns an empty string if the unique device ID does not exist.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
function getUniqueDeviceId(slotId: number, callback: AsyncCallback<string>): void;
/**
* Obtains the unique device ID of a specified card slot of the device.
*
* If the device is registered with a 3GPP-compliant network, the international mobile equipment identity
* (IMEI) is returned. If the device is registered with a 3GPP2-compliant network, the mobile equipment identifier
* (MEID) is returned.
*
* @permission ohos.permission.GET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot
* index number supported by the device.
* @returns { Promise<string> } Returns the unique device ID.
* Returns an empty string if the unique device ID does not exist.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
function getUniqueDeviceId(slotId?: number): Promise<string>;
/**
* Obtains the unique device ID of a specified card slot of the device.
*
* If the device is registered with a 3GPP-compliant network, the international mobile equipment identity
* (IMEI) is returned. If the device is registered with a 3GPP2-compliant network, the mobile equipment identifier
* (MEID) is returned.
*
* @permission ohos.permission.GET_TELEPHONY_STATE
* @param { AsyncCallback<string> } callback - Indicates the callback for getting the unique device ID.
* Returns an empty string if the unique device ID does not exist.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
function getUniqueDeviceId(callback: AsyncCallback<string>): void;
/**
* Obtains the index number of the card slot where the primary card is located if multiple SIM cards are inserted.
*
* The primary card is the SIM card inserted in the card slot that uses data services by default.
*
* @param { AsyncCallback<number> } callback - Indicates the callback for getting the index number of
* the primary card slot.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @since 7
*/
function getPrimarySlotId(callback: AsyncCallback<number>): void;
/**
* Obtains the index number of the card slot where the primary card is located if multiple SIM cards are inserted.
*
* The primary card is the SIM card inserted in the card slot that uses data services by default.
*
* @returns { Promise<number> } Returns the index number of the primary card slot.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @since 7
*/
function getPrimarySlotId(): Promise<number>;
/**
* Set the index number of the main SIM card slot.
*
* @permission ohos.permission.SET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot
* index number supported by the device.
* @param { AsyncCallback<void> } callback - The callback of setPrimarySlotId.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300004 - No SIM card found.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
function setPrimarySlotId(slotId: number, callback: AsyncCallback<void>): void;
/**
* Set the index number of the main SIM card slot.
*
* @permission ohos.permission.SET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot
* index number supported by the device.
* @returns { Promise<void> } The promise returned by the setPrimarySlotId.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300004 - No SIM card found.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
function setPrimarySlotId(slotId: number): Promise<void>;
/**
* Obtains the list of signal strength information of the registered network corresponding to a specified SIM card.
*
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot
* index number supported by the device.
* @param { AsyncCallback<Array<SignalInformation>> } callback - Indicates the callback for getting
* the instance list of the child classes derived from {@link SignalInformation}.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @since 7
*/
function getSignalInformation(slotId: number, callback: AsyncCallback<Array<SignalInformation>>): void;
/**
* Obtains the list of signal strength information of the registered network corresponding to a specified SIM card.
*
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot
* index number supported by the device.
* @returns { Promise<Array<SignalInformation>> } Returns the callback for getting the instance list of
* the child classes derived from {@link SignalInformation}.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @since 7
*/
function getSignalInformation(slotId: number): Promise<Array<SignalInformation>>;
/**
* Obtains the list of signal strength information of the registered network corresponding to a specified SIM card.
*
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum
* card slots supported by the device.
* @returns { Array<SignalInformation> } Returns the callback for getting the instance list of
* the child classes derived from {@link SignalInformation}.
* @syscap SystemCapability.Telephony.CoreService
* @since 10
*/
function getSignalInformationSync(slotId: number): Array<SignalInformation>;
/**
* Checks whether the device supports 5G New Radio (NR).
*
* @returns { boolean } Returns {@code true} if the device supports 5G NR; returns {@code false} otherwise.
* @syscap SystemCapability.Telephony.CoreService
* @since 7
* @deprecated since 9
* @useinstead telephony.radio#isNRSupported
*/
function isNrSupported(): boolean;
/**
* Checks whether the device supports 5G New Radio (NR) by according card slot.
*
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot
* index number supported by the device.
* @returns { boolean } Returns {@code true} if the device supports 5G NR; returns {@code false} otherwise.
* @syscap SystemCapability.Telephony.CoreService
* @since 8
* @deprecated since 9
* @useinstead telephony.radio#isNRSupported
*/
function isNrSupported(slotId: number): boolean;
/**
* Checks whether the device supports 5G New Radio (NR).
*
* @returns { boolean } Returns {@code true} if the device supports 5G NR; returns {@code false} otherwise.
* @syscap SystemCapability.Telephony.CoreService
* @since 9
*/
function isNRSupported(): boolean;
/**
* Checks whether the device supports 5G New Radio (NR) by according card slot.
*
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot
* index number supported by the device.
* @returns { boolean } Returns {@code true} if the device supports 5G NR; returns {@code false} otherwise.
* @syscap SystemCapability.Telephony.CoreService
* @since 9
*/
function isNRSupported(slotId: number): boolean;
/**
* Checks whether the radio service is enabled.
*
* @permission ohos.permission.GET_NETWORK_INFO
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slot index number supported by the device.
* @param { AsyncCallback<boolean> } callback - Returns {@code true} If the radio service is enabled.
* Returns {@code false} otherwise.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @since 7
*/
function isRadioOn(slotId: number, callback: AsyncCallback<boolean>): void;
/**
* Checks whether the radio service is enabled.
*
* @permission ohos.permission.GET_NETWORK_INFO
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slot index number supported by the device.
* @returns { Promise<boolean> } Returns {@code true} If the radio service is enabled; returns {@code false} otherwise.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @since 7
*/
function isRadioOn(slotId?: number): Promise<boolean>;
/**
* Checks whether the radio service is enabled.
*
* @permission ohos.permission.GET_NETWORK_INFO
* @param { AsyncCallback<boolean> } callback - Returns {@code true} If the radio service is enabled.
* Returns {@code false} otherwise.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @since 7
*/
function isRadioOn(callback: AsyncCallback<boolean>): void;
/**
* Turn on the radio service.
*
* @permission ohos.permission.SET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slot index number supported by the device.
* @param { AsyncCallback<void> } callback - The callback of turnOnRadio.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 7
*/
function turnOnRadio(slotId: number, callback: AsyncCallback<void>): void;
/**
* Turn on the radio service.
*
* @permission ohos.permission.SET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slot index number supported by the device.
* @returns { Promise<void> } The promise returned by the turnOnRadio.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 7
*/
function turnOnRadio(slotId?: number): Promise<void>;
/**
* Turn on the radio service.
*
* @permission ohos.permission.SET_TELEPHONY_STATE
* @param { AsyncCallback<void> } callback - The callback of turnOnRadio.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 7
*/
function turnOnRadio(callback: AsyncCallback<void>): void;
/**
* Turn off the radio service.
*
* @permission ohos.permission.SET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slot index number supported by the device.
* @param { AsyncCallback<void> } callback - The callback of turnOffRadio.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 7
*/
function turnOffRadio(slotId: number, callback: AsyncCallback<void>): void;
/**
* Turn off the radio service.
*
* @permission ohos.permission.SET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slot index number supported by the device.
* @returns { Promise<void> } The promise returned by the turnOffRadio.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 7
*/
function turnOffRadio(slotId?: number): Promise<void>;
/**
* Turn off the radio service.
*
* @permission ohos.permission.SET_TELEPHONY_STATE
* @param { AsyncCallback<void> } callback - The callback of turnOffRadio.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 7
*/
function turnOffRadio(callback: AsyncCallback<void>): void;
/**
* Get the operator name of the specified SIM card slot.
*
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slot index number supported by the device.
* @param { AsyncCallback<string> } callback - Indicates the callback for getting the operator name.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @since 7
*/
function getOperatorName(slotId: number, callback: AsyncCallback<string>): void;
/**
* Get the operator name of the specified SIM card slot.
*
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slot index number supported by the device.
* @returns { Promise<string> } Returns the operator name.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @since 7
*/
function getOperatorName(slotId: number): Promise<string>;
/**
* Get the operator name of the specified SIM card slot.
*
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slot index number supported by the device.
* @returns { string } Returns the operator name.
* @syscap SystemCapability.Telephony.CoreService
* @since 10
*/
function getOperatorNameSync(slotId: number): string;
/**
* Set the preferred network for the specified SIM card slot.
*
* @permission ohos.permission.SET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slot index number supported by the device.
* @param { PreferredNetworkMode } networkMode - Indicates that you want to set the preferred network mode.
* @param { AsyncCallback<void> } callback - The callback of setPreferredNetwork.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
function setPreferredNetwork(slotId: number, networkMode: PreferredNetworkMode, callback: AsyncCallback<void>): void;
/**
* Set the preferred network for the specified SIM card slot.
*
* @permission ohos.permission.SET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slot index number supported by the device.
* @param { PreferredNetworkMode } networkMode - Indicates that you want to set the preferred network mode.
* @returns { Promise<void> } The promise returned by the setPreferredNetwork.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
function setPreferredNetwork(slotId: number, networkMode: PreferredNetworkMode): Promise<void>;
/**
* Get the preferred network for the specified SIM card slot.
*
* @permission ohos.permission.GET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slot index number supported by the device.
* @param { AsyncCallback<PreferredNetworkMode> } callback - Indicates the callback for getting
* the preferred network mode to obtain.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
function getPreferredNetwork(slotId: number, callback: AsyncCallback<PreferredNetworkMode>): void;
/**
* Get the preferred network for the specified SIM card slot.
*
* @permission ohos.permission.GET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slot index number supported by the device.
* @returns { Promise<PreferredNetworkMode> } Returns the callback for getting the preferred network mode to obtain.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
function getPreferredNetwork(slotId: number): Promise<PreferredNetworkMode>;
/**
* Get the IMS registration state info of specified IMS service type.
*
* @permission ohos.permission.GET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slot index number supported by the device.
* @param { ImsServiceType } imsType - Indicates the ims service type of the {@link ImsServiceType}.
* @param { AsyncCallback<ImsRegInfo> } callback - Indicates an instance of the {@link ImsRegInfo} class.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 9
*/
function getImsRegInfo(slotId: number, imsType: ImsServiceType, callback: AsyncCallback<ImsRegInfo>): void;
/**
* Get the IMS registration state info of specified IMS service type.
*
* @permission ohos.permission.GET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slot index number supported by the device.
* @param { ImsServiceType } imsType - Indicates the ims service type of the {@link ImsServiceType}.
* @returns { Promise<ImsRegInfo> } Returns an instance of the {@link ImsRegInfo} class.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 9
*/
function getImsRegInfo(slotId: number, imsType: ImsServiceType): Promise<ImsRegInfo>;
/**
* Called when the IMS registration state of specified IMS service type corresponding to
* a monitored {@code slotId} updates.
*
* @permission ohos.permission.GET_TELEPHONY_STATE
* @param { 'imsRegStateChange' } type - Event type. Indicates the imsRegStateChange event to be subscribed to.
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slot index number supported by the device.
* @param { ImsServiceType } imsType - Indicates the ims service type of the {@link ImsServiceType}.
* @param { Callback<ImsRegInfo> } callback - Indicates the callback for getting an instance of
* the {@link ImsRegInfo} class.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 9
*/
function on(type: 'imsRegStateChange', slotId: number, imsType: ImsServiceType, callback: Callback<ImsRegInfo>): void;
/**
* Unsubscribe from imsRegStateChange event.
*
* @permission ohos.permission.GET_TELEPHONY_STATE
* @param { 'imsRegStateChange' } type - Event type. Indicates the imsRegStateChange event to unsubscribe from.
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slot index number supported by the device.
* @param { ImsServiceType } imsType - Indicates the ims service type of the {@link ImsServiceType}.
* @param { Callback<ImsRegInfo> } callback - Indicates the callback for getting
* an instance of the {@link ImsRegInfo} class.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 9
*/
function off(type: 'imsRegStateChange', slotId: number, imsType: ImsServiceType, callback?: Callback<ImsRegInfo>): void;
/**
* Get the version of Baseband.
*
* @permission ohos.permission.GET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number
* supported by the device.
* @param { AsyncCallback<string> } callback - Indicates the callback for getting the baseband version.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 10
*/
function getBasebandVersion(slotId: number, callback: AsyncCallback<string>): void;
/**
* Get the version of Baseband.
*
* @permission ohos.permission.GET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number
* supported by the device.
* @returns { Promise<string> } Returns the baseband version.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 10
*/
function getBasebandVersion(slotId: number): Promise<string>;
/**
* Set the NR option mode.
*
* @permission ohos.permission.SET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index
* number supported by the device.
* @param { NROptionMode } mode - Indicates the nr option mode to be set.
* @param { AsyncCallback<void> } callback - Indicates the callback for getting the option result.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 10
*/
function setNROptionMode(slotId: number, mode: NROptionMode, callback: AsyncCallback<void>): void;
/**
* Set the NR option mode.
*
* @permission ohos.permission.SET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index
* number supported by the device.
* @param { NROptionMode } mode - Indicates the nr option mode to be set.
* @returns { Promise<void> } Returns option result.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 10
*/
function setNROptionMode(slotId: number, mode: NROptionMode): Promise<void>;
/**
* Get the option mode of NR.
*
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot
* index number supported by the device.
* @param { AsyncCallback<NROptionMode> } callback - Indicates the callback for getting the selection mode of NR.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 10
*/
function getNROptionMode(slotId: number, callback: AsyncCallback<NROptionMode>): void;
/**
* Get the option mode of NR.
*
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot
* index number supported by the device.
* @returns { Promise<NROptionMode> } Returns the selection mode of NR.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 10
*/
function getNROptionMode(slotId: number): Promise<NROptionMode>;
/**
* Set the type and state for the specified network capability.
*
* @permission ohos.permission.SET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slot index number supported by the device.
* @param { NetworkCapabilityType } type - Indicates the service type of the {@link NetworkCapabilityType}.
* @param { NetworkCapabilityState } state - Indicates the service ability state of the {@link NetworkCapabilityState}.
* @param { AsyncCallback<void> } callback - The callback of setNetworkCapability.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 10
*/
function setNetworkCapability(slotId: number, type: NetworkCapabilityType, state: NetworkCapabilityState,
callback: AsyncCallback<void>): void;
/**
* Set the type and state for the specified network capability.
*
* @permission ohos.permission.SET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slot index number supported by the device.
* @param { NetworkCapabilityType } type - Indicates the service type of the {@link NetworkCapabilityType}.
* @param { NetworkCapabilityState } state - Indicates the service ability state of the {@link NetworkCapabilityState}.
* @returns { Promise<void> } The promise returned by the setNetworkCapability.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 10
*/
function setNetworkCapability(slotId: number, type: NetworkCapabilityType, state: NetworkCapabilityState): Promise<void>;
/**
* Get the network capability state according to the specified capability type.
*
* @permission ohos.permission.GET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slot index number supported by the device.
* @param { NetworkCapabilityType } type - Indicates the service type of the {@link NetworkCapabilityType}.
* @param { AsyncCallback<NetworkCapabilityState> } callback - Indicates the callback for getting
* the network capability state.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 10
*/
function getNetworkCapability(slotId: number, type: NetworkCapabilityType,
callback: AsyncCallback<NetworkCapabilityState>): void;
/**
* Get the network capability state according to the specified capability type.
*
* @permission ohos.permission.GET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number,
* ranging from 0 to the maximum card slot index number supported by the device.
* @param { NetworkCapabilityType } type - Indicates the service type of the {@link NetworkCapabilityType}.
* @returns { Promise<NetworkCapabilityState> } Returns the callback for getting the network capability state.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 10
*/
function getNetworkCapability(slotId: number, type: NetworkCapabilityType): Promise<NetworkCapabilityState>;
/**
* Reset all network settings of telephony.
*
* @permission ohos.permission.SET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot
* index number supported by the device.
* @returns { Promise<void> } The promise returned by the factoryReset.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 11
*/
function factoryReset(slotId: number): Promise<void>;
/**
* Obtains the software version number of a specified card slot of the device.
*
* @permission ohos.permission.GET_TELEPHONY_STATE
* @param { number } slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number
* supported by the device.
* @returns { string } Returns the IMEISV. Returns an empty string if the IMEISV does not exist.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Non-system applications use system APIs.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
* 2. Incorrect parameter types.
* @throws { BusinessError } 8300001 - Invalid parameter value.
* @throws { BusinessError } 8300002 - Service connection failed.
* @throws { BusinessError } 8300003 - System internal error.
* @throws { BusinessError } 8300999 - Unknown error.
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 12
*/
function getIMEISV(slotId: number): string;
/**
* Indicates the preferred network.
*
* @enum { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
export enum PreferredNetworkMode {
/**
* Preferred GSM network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_GSM = 1,
/**
* Preferred WCDMA network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_WCDMA = 2,
/**
* Preferred LTE mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_LTE = 3,
/**
* Preferred LTE/WCDMA network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_LTE_WCDMA = 4,
/**
* Preferred LTE/WCDMA/GSM network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_LTE_WCDMA_GSM = 5,
/**
* Preferred WCDMA/GSM network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_WCDMA_GSM = 6,
/**
* Preferred CDMA network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_CDMA = 7,
/**
* Preferred EVDO network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_EVDO = 8,
/**
* Preferred EVDO/CDMA network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_EVDO_CDMA = 9,
/**
* Preferred WCDMA/GSM/EVDO/CDMA network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_WCDMA_GSM_EVDO_CDMA = 10,
/**
* Preferred LTE/EVDO/CDMA network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_LTE_EVDO_CDMA = 11,
/**
* Preferred LTE/WCDMA/GSM/EVDO/CDMA network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_LTE_WCDMA_GSM_EVDO_CDMA = 12,
/**
* Preferred TDSCDMA network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_TDSCDMA = 13,
/**
* Preferred TDSCDMA/GSM network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_TDSCDMA_GSM = 14,
/**
* Preferred TDSCDMA/WCDMA network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_TDSCDMA_WCDMA = 15,
/**
* Preferred TDSCDMA/WCDMA/GSM network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_TDSCDMA_WCDMA_GSM = 16,
/**
* Preferred LTE/TDSCDMA network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_LTE_TDSCDMA = 17,
/**
* Preferred LTE/TDSCDMA/GSM network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_LTE_TDSCDMA_GSM = 18,
/**
* Preferred LTE/TDSCDMA/WCDMA network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_LTE_TDSCDMA_WCDMA = 19,
/**
* Preferred LTE/TDSCDMA/WCDMA/GSM network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_LTE_TDSCDMA_WCDMA_GSM = 20,
/**
* Preferred TDSCDMA/WCDMA/GSM/EVDO/CDMA network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_TDSCDMA_WCDMA_GSM_EVDO_CDMA = 21,
/**
* Preferred LTE/TDSCDMA/WCDMA/GSM/EVDO/CDMA network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_LTE_TDSCDMA_WCDMA_GSM_EVDO_CDMA = 22,
/**
* Preferred NR network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_NR = 31,
/**
* Preferred NR/LTE network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_NR_LTE = 32,
/**
* Preferred NR/LTE/WCDMA network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_NR_LTE_WCDMA = 33,
/**
* Preferred NR/LTE/WCDMA/GSM network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_NR_LTE_WCDMA_GSM = 34,
/**
* Preferred NR/LTE/EVDO/CDMA network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_NR_LTE_EVDO_CDMA = 35,
/**
* Preferred NR/LTE/WCDMA/GSM/EVDO/CDMA network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_NR_LTE_WCDMA_GSM_EVDO_CDMA = 36,
/**
* Preferred NR/LTE/TDSCDMA network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_NR_LTE_TDSCDMA = 37,
/**
* Preferred NR/LTE/TDSCDMA/GSM network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_NR_LTE_TDSCDMA_GSM = 38,
/**
* Preferred NR/LTE/TDSCDMA/WCDMA network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_NR_LTE_TDSCDMA_WCDMA = 39,
/**
* Preferred NR/LTE/TDSCDMA/WCDMA/GSM network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_NR_LTE_TDSCDMA_WCDMA_GSM = 40,
/**
* Preferred NR/LTE/TDSCDMA/WCDMA/GSM/EVDO/CDMA network mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_NR_LTE_TDSCDMA_WCDMA_GSM_EVDO_CDMA = 41,
/**
* Preferred network mode Maximum.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
PREFERRED_NETWORK_MODE_MAX_VALUE = 99,
}
/**
* Describes the radio access technology (RAT) of registered network.
*
* @interface NetworkRadioTech
* @syscap SystemCapability.Telephony.CoreService
* @since 11
*/
export interface NetworkRadioTech {
/**
* Indicates radio access technology (RAT) of packet service (PS) domain.
*
* @type { RadioTechnology }
* @syscap SystemCapability.Telephony.CoreService
* @since 11
*/
psRadioTech: RadioTechnology;
/**
* Indicates radio access technology (RAT) of circuit service (CS) domain.
*
* @type { RadioTechnology }
* @syscap SystemCapability.Telephony.CoreService
* @since 11
*/
csRadioTech: RadioTechnology;
}
/**
* Describes the radio access technology.
*
* @enum { number }
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
export enum RadioTechnology {
/**
* Indicates unknown radio access technology (RAT).
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
RADIO_TECHNOLOGY_UNKNOWN = 0,
/**
* Indicates that RAT is global system for mobile communications (GSM), including GSM, general packet
* radio system (GPRS), and enhanced data rates for GSM evolution (EDGE).
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
RADIO_TECHNOLOGY_GSM = 1,
/**
* Indicates that RAT is code division multiple access (CDMA), including Interim Standard 95 (IS95) and
* Single-Carrier Radio Transmission Technology (1xRTT).
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
RADIO_TECHNOLOGY_1XRTT = 2,
/**
* Indicates that RAT is wideband code division multiple address (WCDMA).
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
RADIO_TECHNOLOGY_WCDMA = 3,
/**
* Indicates that RAT is high-speed packet access (HSPA), including HSPA, high-speed downlink packet
* access (HSDPA), and high-speed uplink packet access (HSUPA).
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
RADIO_TECHNOLOGY_HSPA = 4,
/**
* Indicates that RAT is evolved high-speed packet access (HSPA+), including HSPA+ and dual-carrier
* HSPA+ (DC-HSPA+).
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
RADIO_TECHNOLOGY_HSPAP = 5,
/**
* Indicates that RAT is time division-synchronous code division multiple access (TD-SCDMA).
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
RADIO_TECHNOLOGY_TD_SCDMA = 6,
/**
* Indicates that RAT is evolution data only (EVDO), including EVDO Rev.0, EVDO Rev.A, and EVDO Rev.B.
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
RADIO_TECHNOLOGY_EVDO = 7,
/**
* Indicates that RAT is evolved high rate packet data (EHRPD).
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
RADIO_TECHNOLOGY_EHRPD = 8,
/**
* Indicates that RAT is long term evolution (LTE).
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
RADIO_TECHNOLOGY_LTE = 9,
/**
* Indicates that RAT is LTE carrier aggregation (LTE-CA).
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
RADIO_TECHNOLOGY_LTE_CA = 10,
/**
* Indicates that RAT is interworking WLAN (I-WLAN).
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
RADIO_TECHNOLOGY_IWLAN = 11,
/**
* Indicates that RAT is 5G new radio (NR).
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
RADIO_TECHNOLOGY_NR = 12
}
/**
* Returns child class objects specific to the network type.
*
* @interface SignalInformation
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
export interface SignalInformation {
/**
* Obtains the network type corresponding to the signal.
*
* @type { NetworkType }
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
signalType: NetworkType;
/**
* Obtains the signal level of the current network.
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
signalLevel: number;
/**
* rsrp for LTE and NR; dbm for CDMA and EVDO; rscp for WCDMA; rssi for GSM.
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @since 9
*/
dBm: number;
}
/**
* Describes the network type.
*
* @enum { number }
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
export enum NetworkType {
/**
* Indicates unknown network type.
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
NETWORK_TYPE_UNKNOWN,
/**
* Indicates that the network type is GSM.
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
NETWORK_TYPE_GSM,
/**
* Indicates that the network type is CDMA.
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
NETWORK_TYPE_CDMA,
/**
* Indicates that the network type is WCDMA.
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
NETWORK_TYPE_WCDMA,
/**
* Indicates that the network type is TD-SCDMA.
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
NETWORK_TYPE_TDSCDMA,
/**
* Indicates that the network type is LTE.
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
NETWORK_TYPE_LTE,
/**
* Indicates that the network type is 5G NR.
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
NETWORK_TYPE_NR
}
/**
* Describes the network registration state.
*
* @interface NetworkState
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
export interface NetworkState {
/**
* Obtains the operator name in the long alphanumeric format of the registered network.
*
* Returns the operator name in the long alphanumeric format as a string;
* returns an empty string if no operator name is obtained.
*
* @type { string }
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
longOperatorName: string;
/**
* Obtains the operator name in the short alphanumeric format of the registered network.
*
* Returns the operator name in the short alphanumeric format as a string;
* returns an empty string if no operator name is obtained.
*
* @type { string }
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
shortOperatorName: string;
/**
* Obtains the PLMN code of the registered network.
*
* Returns the PLMN code as a string; returns an empty string if no operator name is obtained.
*
* @type { string }
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
plmnNumeric: string;
/**
* Checks whether the device is roaming.
*
* @type { boolean }
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
isRoaming: boolean;
/**
* Obtains the network registration status of the device.
*
* @type { RegState }
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
regState: RegState;
/**
* Obtains the radio Access technology after config conversion.
*
* @type { RadioTechnology }
* @syscap SystemCapability.Telephony.CoreService
* @since 8
*/
cfgTech: RadioTechnology;
/**
* Obtains the NSA network registration status of the device.
*
* Returns the NSA network registration status {@code NsaState}.
*
* @type { NsaState }
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
nsaState: NsaState;
/**
* Obtains the status of CA.
*
* Returns {@code true} if CA is actived; returns {@code false} otherwise.
*
* @type { boolean }
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
isCaActive: boolean;
/**
* Checks whether this device is allowed to make emergency calls only.
*
* Returns {@code true} if this device is allowed to make emergency calls only;
* returns {@code false} otherwise.
*
* @type { boolean }
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
isEmergency: boolean;
}
/**
* Describes the network registration state.
*
* @enum { number }
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
export enum RegState {
/**
* Indicates a state in which a device cannot use any service.
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
REG_STATE_NO_SERVICE = 0,
/**
* Indicates a state in which a device can use services properly.
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
REG_STATE_IN_SERVICE = 1,
/**
* Indicates a state in which a device can use only the emergency call service.
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
REG_STATE_EMERGENCY_CALL_ONLY = 2,
/**
* Indicates that the cellular radio is powered off.
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
REG_STATE_POWER_OFF = 3
}
/**
* Describes the nsa state.
*
* @enum { number }
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
export enum NsaState {
/**
* Indicates that a device is idle under or is connected to an LTE cell that does not support NSA.
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
NSA_STATE_NOT_SUPPORT = 1,
/**
* Indicates that a device is idle under an LTE cell supporting NSA but not NR coverage detection.
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
NSA_STATE_NO_DETECT = 2,
/**
* Indicates that a device is connected to an LTE network under an LTE cell
* that supports NSA and NR coverage detection.
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
NSA_STATE_CONNECTED_DETECT = 3,
/**
* Indicates that a device is idle under an LTE cell supporting NSA and NR coverage detection.
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
NSA_STATE_IDLE_DETECT = 4,
/**
* Indicates that a device is connected to an LTE + NR network under an LTE cell that supports NSA.
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
NSA_STATE_DUAL_CONNECTED = 5,
/**
* Indicates that a device is idle under or is connected to an NG-RAN cell while being attached to 5GC.
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
NSA_STATE_SA_ATTACHED = 6
}
/**
* Obtains current cell information.
*
* @interface CellInformation
* @syscap SystemCapability.Telephony.CoreService
* @since 8
*/
export interface CellInformation {
/**
* Obtains the network type of the serving cell.
*
* An application can call this method to determine the network type that the child class uses.
*
* @type { NetworkType }
* @syscap SystemCapability.Telephony.CoreService
* @since 8
*/
networkType: NetworkType;
/**
* Obtains the camp-on status of the serving cell.
*
* Returns {@code true} if the user equipment (UE) is camped on the cell; returns {@code false} otherwise.
*
* @type { boolean }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
isCamped: boolean;
/**
* Obtains the timestamp when the cell information is obtained.
*
* Returns a timestamp since boot, in nanoseconds.
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
timeStamp: number;
/**
* An abstract method of the parent class whose implementation depends on the child classes.
* Returned child class objects vary according to the network type.
* Returns child class objects specific to the network type.
*
* @type { SignalInformation }
* @syscap SystemCapability.Telephony.CoreService
* @since 8
*/
signalInformation: SignalInformation;
/**
* Obtains signal strength under different network formats.
*
* @type { CdmaCellInformation | GsmCellInformation | LteCellInformation | NrCellInformation
* | TdscdmaCellInformation | WcdmaCellInformation }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
data: CdmaCellInformation | GsmCellInformation | LteCellInformation | NrCellInformation | TdscdmaCellInformation
| WcdmaCellInformation;
}
/**
* Obtains CDMA cell information.
*
* @interface CdmaCellInformation
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
export interface CdmaCellInformation {
/**
* Indicates the base station Id.
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
baseId: number;
/**
* Indicates the latitude.
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
latitude: number;
/**
* Indicates the longitude.
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
longitude: number;
/**
* Indicates the network identification code.
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
nid: number;
/**
* Indicates the system identification code.
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
sid: number;
}
/**
* Obtains GSM cell information.
*
* @interface GsmCellInformation
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
export interface GsmCellInformation {
/**
* Indicates the location area code.
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
lac: number;
/**
* Indicates the cell identification.
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
cellId: number;
/**
* Indicates the ARFCN(absolute radio frequency channel number).
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
arfcn: number;
/**
* Indicates the base station identification code.
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
bsic: number;
/**
* Indicates the mobile country code.
*
* @type { string }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
mcc: string;
/**
* Indicates the mobile network code.
*
* @type { string }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
mnc: string;
}
/**
* Obtains LTE cell information.
*
* @interface LteCellInformation
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
export interface LteCellInformation {
/**
* Indicates the cell global identification.
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
cgi: number;
/**
* Indicates the physical cell identification.
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
pci: number;
/**
* Indicates the tracking area code.
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
tac: number;
/**
* Indicates the E-UTRA Absolute Radio Frequency Channel Number.
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
earfcn: number;
/**
* Indicates the bandwidth.
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
bandwidth: number;
/**
* Indicates the mobile country code.
*
* @type { string }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
mcc: string;
/**
* Indicates the mobile network code.
*
* @type { string }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
mnc: string;
/**
* Support for New Radio_Dual Connectivity.
*
* @type { boolean }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
isSupportEndc: boolean;
}
/**
* Obtains NR cell information.
*
* @interface NrCellInformation
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
export interface NrCellInformation {
/**
* Indicates the NR-ARFCN(NR Absolute Radio Frequency Channel Number).
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
nrArfcn: number;
/**
* Indicates the physical cell identification.
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
pci: number;
/**
* Indicates the tracking area code.
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
tac: number;
/**
* Indicates the 5G network cell ID.
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
nci: number;
/**
* Indicates the mobile country code.
*
* @type { string }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
mcc: string;
/**
* Indicates the mobile network code.
*
* @type { string }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
mnc: string;
}
/**
* Obtains TDSCDMA cell information.
*
* @interface TdscdmaCellInformation
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
export interface TdscdmaCellInformation {
/**
* Indicates the location area code.
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
lac: number;
/**
* Indicates the cell ID.
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
cellId: number;
/**
* Indicates the cell parameter ID.
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
cpid: number;
/**
* Indicates the absolute radio frequency number.
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
uarfcn: number;
/**
* Indicates the mobile country code.
*
* @type { string }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
mcc: string;
/**
* Indicates the mobile network code.
*
* @type { string }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
mnc: string;
}
/**
* Obtains WCDMA cell information.
*
* @interface WcdmaCellInformation
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
export interface WcdmaCellInformation {
/**
* Indicates the location area code.
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
lac: number;
/**
* Indicates the cell ID.
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
cellId: number;
/**
* Indicates the primary scrambling code.
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
psc: number;
/**
* Indicates the absolute radio frequency number.
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
uarfcn: number;
/**
* Indicates the mobile country code.
*
* @type { string }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
mcc: string;
/**
* Indicates the mobile network code.
*
* @type { string }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
*/
mnc: string;
}
/**
* Obtains the option mode of NR.
*
* @enum { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
* @deprecated since 10
* @useinstead telephony.radio#NROptionMode
*/
export enum NrOptionMode {
/**
* Indicates unknown NR networking mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
* @deprecated since 10
*/
NR_OPTION_UNKNOWN,
/**
* Indicates that the NR networking mode is NSA only.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
* @deprecated since 10
*/
NR_OPTION_NSA_ONLY,
/**
* Indicates that the NR networking mode is SA only.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
* @deprecated since 10
*/
NR_OPTION_SA_ONLY,
/**
* Indicates that the NR networking mode is NSA and SA.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 8
* @deprecated since 10
*/
NR_OPTION_NSA_AND_SA,
}
/**
* Obtains the option mode of NR.
*
* @enum { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 10
*/
export enum NROptionMode {
/**
* Indicates unknown NR networking mode.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 10
*/
NR_OPTION_UNKNOWN,
/**
* Indicates that the NR networking mode is NSA only.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 10
*/
NR_OPTION_NSA_ONLY,
/**
* Indicates that the NR networking mode is SA only.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 10
*/
NR_OPTION_SA_ONLY,
/**
* Indicates that the NR networking mode is NSA and SA.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 10
*/
NR_OPTION_NSA_AND_SA,
}
/**
* Obtains the network search results.
*
* @interface NetworkSearchResult
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 6
*/
export interface NetworkSearchResult {
/**
* Indicates whether the network search was successful.
*
* @type { boolean }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 6
*/
isNetworkSearchSuccess: boolean;
/**
* Obtains the network search results.
*
* @type { Array<NetworkInformation> }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 6
*/
networkSearchResult: Array<NetworkInformation>;
}
/**
* Obtains the network information.
*
* @interface NetworkInformation
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 6
*/
export interface NetworkInformation {
/**
* Indicates the name of the operator.
*
* @type { string }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 6
*/
operatorName: string;
/**
* Indicates the number of the operator.
*
* @type { string }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 6
*/
operatorNumeric: string;
/**
* Indicates the status of network information.
*
* @type { NetworkInformationState }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 6
*/
state: NetworkInformationState;
/**
* Indicates the radio Technology.
*
* @type { string }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 6
*/
radioTech: string;
}
/**
* Obtains network information status.
*
* @enum { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 6
*/
export enum NetworkInformationState {
/**
* Indicates that the network state is unknown.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 6
*/
NETWORK_UNKNOWN,
/**
* Indicates that the network is available for registration.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 6
*/
NETWORK_AVAILABLE,
/**
* Indicates that you have already registered with the network.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 6
*/
NETWORK_CURRENT,
/**
* Indicates that the network is unavailable for registration.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 6
*/
NETWORK_FORBIDDEN
}
/**
* Obtains the network selection mode option.
*
* @interface NetworkSelectionModeOptions
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 6
*/
export interface NetworkSelectionModeOptions {
/**
* Indicates the card slot index number, ranging from 0 to
* the maximum card slot index number supported by the device.
*
* @type { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 6
*/
slotId: number;
/**
* Indicates the network search mode of the SIM card.
*
* @type { NetworkSelectionMode }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 6
*/
selectMode: NetworkSelectionMode;
/**
* Indicates the network information.
*
* @type { NetworkInformation }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 6
*/
networkInformation: NetworkInformation;
/**
* Indicates whether to continue selecting the network selection mode.
*
* @type { boolean }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 6
*/
resumeSelection: boolean;
}
/**
* Obtains the network selection mode.
*
* @enum { number }
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
export enum NetworkSelectionMode {
/**
* Indicates that the network is unavailable for registration.
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
NETWORK_SELECTION_UNKNOWN,
/**
* Indicates that the network is unavailable for registration.
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
NETWORK_SELECTION_AUTOMATIC,
/**
* Manual network selection modes.
*
* @syscap SystemCapability.Telephony.CoreService
* @since 6
*/
NETWORK_SELECTION_MANUAL
}
/**
* Obtains IMS registration status.
*
* @enum { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 9
*/
export enum ImsRegState {
/**
* Indicates that the ims service is not registered.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 9
*/
IMS_UNREGISTERED,
/**
* Indicates that the ims service has been registered.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 9
*/
IMS_REGISTERED,
}
/**
* Indicates IMS registration technology.
*
* @enum { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 9
*/
export enum ImsRegTech {
/**
* Indicates that ims has no registered technology.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 9
*/
REGISTRATION_TECH_NONE,
/**
* Indicates that ims registers LTE technology.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 9
*/
REGISTRATION_TECH_LTE,
/**
* Indicates that ims registers IWLAN technology.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 9
*/
REGISTRATION_TECH_IWLAN,
/**
* Indicates that ims registers NR technology.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 9
*/
REGISTRATION_TECH_NR,
}
/**
* Indicates IMS registration information.
*
* @interface ImsRegInfo
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 9
*/
export interface ImsRegInfo {
/**
* Indicates the registration status of the ims service.
*
* @type { ImsRegState }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 9
*/
imsRegState: ImsRegState;
/**
* Indicates the mode of ims radio technology.
*
* @type { ImsRegTech }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 9
*/
imsRegTech: ImsRegTech;
}
/**
* Indicates the type of IMS service.
*
* @enum { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 9
*/
export enum ImsServiceType {
/**
* Indicates voice service.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 9
*/
TYPE_VOICE,
/**
* Indicates video service.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 9
*/
TYPE_VIDEO,
/**
* Indicates UT service.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 9
*/
TYPE_UT,
/**
* Indicates SMS service.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 9
*/
TYPE_SMS,
}
/**
* Enum for network capability type.
*
* @enum { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 10
*/
export enum NetworkCapabilityType {
/**
* Indicates LTE network switch type.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 10
*/
SERVICE_TYPE_LTE,
/**
* Indicates NR network switch type.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 10
*/
SERVICE_TYPE_NR,
}
/**
* Enum for network capability state.
*
* @enum { number }
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 10
*/
export enum NetworkCapabilityState {
/**
* Indicates turn off network switch.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 10
*/
SERVICE_CAPABILITY_OFF,
/**
* Indicates turn on network switch.
*
* @syscap SystemCapability.Telephony.CoreService
* @systemapi Hide this for inner system use.
* @since 10
*/
SERVICE_CAPABILITY_ON,
}
}
export default radio;
Loading...
马建仓 AI 助手
尝试更多
代码解读
代码找茬
代码优化
1
https://gitee.com/lffl8796/interface_sdk-js.git
git@gitee.com:lffl8796/interface_sdk-js.git
lffl8796
interface_sdk-js
interface_sdk-js
master

搜索帮助