1# @ohos.telephony.data (蜂窝数据) 2 3蜂窝数据提供了移动数据管理能力，包括获取、设置默认移动数据的SIM卡，获取蜂窝数据业务的上下行和分组交换域（PS域）的连接状态，以及检查蜂窝数据业务和漫游是否启用等。 4 5>**说明：** 6> 7>本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 8 9## 导入模块 10 11```js 12import data from '@ohos.telephony.data'; 13``` 14 15## data.getDefaultCellularDataSlotId 16 17getDefaultCellularDataSlotId(callback: AsyncCallback\<number\>): void 18 19获取默认移动数据的SIM卡，使用callback方式作为异步方法。 20 21**系统能力**：SystemCapability.Telephony.CellularData 22 23**参数：** 24 25| 参数名 | 类型 | 必填 | 说明 | 26| -------- | ----------------------- | ---- | ------------------------------------------ | 27| callback | AsyncCallback\<number\> | 是 | 回调函数。<br />0：卡槽1。<br />1：卡槽2。 | 28 29**示例：** 30 31```js 32data.getDefaultCellularDataSlotId((err, data) => { 33 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 34}); 35``` 36 37## data.getDefaultCellularDataSlotId 38 39getDefaultCellularDataSlotId(): Promise\<number\> 40 41获取默认移动数据的SIM卡，使用Promise方式作为异步方法。 42 43**系统能力**：SystemCapability.Telephony.CellularData 44 45**返回值：** 46 47| 类型 | 说明 | 48| ----------------- | ------------------------------------------------------------ | 49| Promise\<number\> | 以Promise形式返回获取默认移动数据的SIM卡。<br />0：卡槽1。<br />1：卡槽2。 | 50 51**示例：** 52 53```js 54let promise = data.getDefaultCellularDataSlotId(); 55promise.then((data) => { 56 console.log(`getDefaultCellularDataSlotId success, promise: data->${JSON.stringify(data)}`); 57}).catch((err) => { 58 console.error(`getDefaultCellularDataSlotId fail, promise: err->${JSON.stringify(err)}`); 59}); 60``` 61 62## data.getDefaultCellularDataSlotIdSync<sup>9+</sup> 63 64getDefaultCellularDataSlotIdSync(): number 65 66获取默认移动数据的SIM卡 67 68**系统能力**：SystemCapability.Telephony.CellularData 69 70**返回值：** 71 72| 类型 | 说明 | 73| ------ | -------------------------------------------------- | 74| number | 获取默认移动数据的SIM卡。<br />0：卡槽1。<br />1：卡槽2。 | 75 76**示例：** 77 78```js 79console.log("Result: "+ data.getDefaultCellularDataSlotIdSync()) 80``` 81 82## data.setDefaultCellularDataSlotId 83 84setDefaultCellularDataSlotId(slotId: number, callback: AsyncCallback\<void\>): void 85 86设置默认移动数据的SIM卡，使用callback方式作为异步方法。 87 88**系统接口：** 此接口为系统接口。 89 90**需要权限**：ohos.permission.SET_TELEPHONY_STATE 91 92**系统能力**：SystemCapability.Telephony.CellularData 93 94**参数：** 95 96| 参数名 | 类型 | 必填 | 说明 | 97| -------- | --------------------- | ---- | ------------------------------------------------------------ | 98| slotId | number | 是 | SIM卡槽ID。<br/>- 0：卡槽1。<br/>- 1：卡槽2。<br/>- -1：清除默认配置。 | 99| callback | AsyncCallback\<void\> | 是 | 回调函数。 | 100 101**错误码：** 102 103以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 104 105| 错误码ID | 错误信息 | 106| -------- | -------------------------------------------- | 107| 201 | Permission denied. | 108| 401 | Parameter error. | 109| 8300001 | Invalid parameter value. | 110| 8300002 | Operation failed. Cannot connect to service. | 111| 8300003 | System internal error. | 112| 8300004 | Do not have sim card. | 113| 8300999 | Unknown error code. | 114| 8301001 | SIM card is not activated. | 115 116**示例：** 117 118```js 119data.setDefaultCellularDataSlotId(0, (err) => { 120 console.log(`callback: err->${JSON.stringify(err)}.`); 121}); 122``` 123 124## data.setDefaultCellularDataSlotId 125 126setDefaultCellularDataSlotId(slotId: number): Promise\<void\> 127 128设置默认移动数据的SIM卡，使用Promise方式作为异步方法。 129 130**系统接口：** 此接口为系统接口。 131 132**需要权限**：ohos.permission.SET_TELEPHONY_STATE 133 134**系统能力**：SystemCapability.Telephony.CellularData 135 136**参数：** 137 138| 参数名 | 类型 | 必填 | 说明 | 139| ------ | ------ | ---- | ------------------------------------------------------------ | 140| slotId | number | 是 | SIM卡槽ID。<br/>- 0：卡槽1。<br/>- 1：卡槽2。<br/>- -1：清除默认配置。 | 141 142**返回值：** 143 144| 类型 | 说明 | 145| --------------- | ------------------------------- | 146| Promise\<void\> | 以Promise形式异步返回设置结果。 | 147 148**错误码：** 149 150以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 151 152| 错误码ID | 错误信息 | 153| -------- | -------------------------------------------- | 154| 201 | Permission denied. | 155| 401 | Parameter error. | 156| 8300001 | Invalid parameter value. | 157| 8300002 | Operation failed. Cannot connect to service. | 158| 8300003 | System internal error. | 159| 8300004 | Do not have sim card. | 160| 8300999 | Unknown error code. | 161| 8301001 | SIM card is not activated. | 162 163**示例：** 164 165```js 166let promise = data.setDefaultCellularDataSlotId(0); 167promise.then(() => { 168 console.log(`setDefaultCellularDataSlotId success.`); 169}).catch((err) => { 170 console.error(`setDefaultCellularDataSlotId fail, promise: err->${JSON.stringify(err)}`); 171}); 172``` 173 174## data.getCellularDataFlowType 175 176getCellularDataFlowType(callback: AsyncCallback\<DataFlowType\>): void 177 178获取蜂窝数据业务的上下行状态，使用callback方式作为异步方法。 179 180**系统能力**：SystemCapability.Telephony.CellularData 181 182**参数：** 183 184| 参数名 | 类型 | 必填 | 说明 | 185| -------- | ---------------------------------------------- | ---- | ---------- | 186| callback | AsyncCallback\<[DataFlowType](#dataflowtype)\> | 是 | 回调函数。 | 187 188**示例：** 189 190```js 191data.getCellularDataFlowType((err, data) => { 192 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 193}); 194``` 195 196## data.getCellularDataFlowType 197 198getCellularDataFlowType(): Promise\<DataFlowType\> 199 200获取蜂窝数据业务的上下行状态，使用Promise方式作为异步方法。 201 202**系统能力**：SystemCapability.Telephony.CellularData 203 204**返回值：** 205 206| 类型 | 说明 | 207| ---------------------------------------- | ----------------------------------------------- | 208| Promise\<[DataFlowType](#dataflowtype)\> | 以Promise形式返回获取蜂窝数据业务的上下行状态。 | 209 210**示例：** 211 212```js 213let promise = data.getCellularDataFlowType(); 214promise.then((data) => { 215 console.log(`test success, promise: data->${JSON.stringify(data)}`); 216}).catch((err) => { 217 console.error(`test fail, promise: err->${JSON.stringify(err)}`); 218}); 219``` 220 221## data.getCellularDataState 222 223getCellularDataState(callback: AsyncCallback\<DataConnectState\>): void 224 225获取分组交换域（PS域）的连接状态，使用callback方式作为异步方法。 226 227**系统能力**：SystemCapability.Telephony.CellularData 228 229**参数：** 230 231| 参数名 | 类型 | 必填 | 说明 | 232| -------- | ------------------------------------------------------ | ---- | ---------- | 233| callback | AsyncCallback\<[DataConnectState](#dataconnectstate)\> | 是 | 回调函数。 | 234 235**示例：** 236 237```js 238data.getCellularDataState((err, data) => { 239 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 240}); 241``` 242 243## data.getCellularDataState 244 245getCellularDataState(): Promise\<DataConnectState\> 246 247获取分组交换域(PS域)的连接状态，使用Promise方式作为异步方法。 248 249**系统能力**：SystemCapability.Telephony.CellularData 250 251**返回值：** 252 253| 类型 | 说明 | 254| ------------------------------------------------ | ------------------------------------- | 255| Promise\<[DataConnectState](#dataconnectstate)\> | 以Promise形式返回获取PS域的连接状态。 | 256 257**示例：** 258 259```js 260let promise = data.getCellularDataState(); 261promise.then((data) => { 262 console.log(`test success, promise: data->${JSON.stringify(data)}`); 263}).catch((err) => { 264 console.error(`test fail, promise: err->${JSON.stringify(err)}`); 265}); 266``` 267 268## data.isCellularDataEnabled 269 270isCellularDataEnabled(callback: AsyncCallback\<boolean\>): void 271 272检查蜂窝数据业务是否启用，使用callback方式作为异步方法。 273 274**需要权限**：ohos.permission.GET_NETWORK_INFO 275 276**系统能力**：SystemCapability.Telephony.CellularData 277 278**参数：** 279 280| 参数名 | 类型 | 必填 | 说明 | 281| -------- | ------------------------ | ---- | ------------------------------------------------------------ | 282| callback | AsyncCallback\<boolean\> | 是 | 回调函数。<br />true：蜂窝数据业务已启用。<br />false：蜂窝数据业务已禁用。 | 283 284**错误码：** 285 286以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 287 288| 错误码ID | 错误信息 | 289| -------- | -------------------------------------------- | 290| 201 | Permission denied. | 291| 401 | Parameter error. | 292| 8300001 | Invalid parameter value. | 293| 8300002 | Operation failed. Cannot connect to service. | 294| 8300003 | System internal error. | 295| 8300999 | Unknown error code. | 296 297**示例：** 298 299```js 300data.isCellularDataEnabled((err, data) => { 301 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 302}); 303``` 304 305## data.isCellularDataEnabled 306 307isCellularDataEnabled(): Promise\<boolean\> 308 309检查蜂窝数据业务是否启用，使用Promise方式作为异步方法。 310 311**需要权限**：ohos.permission.GET_NETWORK_INFO 312 313**系统能力**：SystemCapability.Telephony.CellularData 314 315**返回值：** 316 317| 类型 | 说明 | 318| ------------------ | ------------------------------------------------------------ | 319| Promise\<boolean\> | 以Promise形式返回检查蜂窝数据业务是否启用。<br />true：蜂窝数据业务已启用。<br />false：蜂窝数据业务已禁用。 | 320 321**错误码：** 322 323以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 324 325| 错误码ID | 错误信息 | 326| -------- | -------------------------------------------- | 327| 201 | Permission denied. | 328| 401 | Parameter error. | 329| 8300001 | Invalid parameter value. | 330| 8300002 | Operation failed. Cannot connect to service. | 331| 8300003 | System internal error. | 332| 8300999 | Unknown error code. | 333 334**示例：** 335 336```js 337let promise = data.isCellularDataEnabled(); 338promise.then((data) => { 339 console.log(`test success, promise: data->${JSON.stringify(data)}`); 340}).catch((err) => { 341 console.error(`test fail, promise: err->${JSON.stringify(err)}`); 342}); 343``` 344 345## data.isCellularDataRoamingEnabled 346 347isCellularDataRoamingEnabled(slotId: number, callback: AsyncCallback\<boolean\>): void 348 349检查蜂窝数据业务是否启用漫游，使用callback方式作为异步方法。 350 351**需要权限**：ohos.permission.GET_NETWORK_INFO 352 353**系统能力**：SystemCapability.Telephony.CellularData 354 355**参数：** 356 357| 参数名 | 类型 | 必填 | 说明 | 358| -------- | ------------------------ | ---- | ------------------------------------------------------------ | 359| slotId | number | 是 | 卡槽ID。<br />0：卡槽1。<br />1：卡槽2。 | 360| callback | AsyncCallback\<boolean\> | 是 | 回调函数。<br />true：蜂窝数据业务已启用漫游。<br />false：蜂窝数据业务已禁用漫游。 | 361 362**错误码：** 363 364以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 365 366| 错误码ID | 错误信息 | 367| -------- | -------------------------------------------- | 368| 201 | Permission denied. | 369| 401 | Parameter error. | 370| 8300001 | Invalid parameter value. | 371| 8300002 | Operation failed. Cannot connect to service. | 372| 8300003 | System internal error. | 373| 8300999 | Unknown error code. | 374 375**示例：** 376 377```js 378data.isCellularDataRoamingEnabled(0, (err, data) => { 379 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 380}); 381``` 382 383## data.isCellularDataRoamingEnabled 384 385isCellularDataRoamingEnabled(slotId: number): Promise\<boolean\> 386 387检查蜂窝数据业务是否启用漫游，使用Promise方式作为异步方法。 388 389**需要权限**：ohos.permission.GET_NETWORK_INFO 390 391**系统能力**：SystemCapability.Telephony.CellularData 392 393**参数：** 394 395| 参数名 | 类型 | 必填 | 说明 | 396| ------ | ------ | ---- | ---------------------------------------- | 397| slotId | number | 是 | 卡槽ID。<br />0：卡槽1。<br />1：卡槽2。 | 398 399**返回值：** 400 401| 类型 | 说明 | 402| ------------------ | ------------------------------------------------------------ | 403| Promise\<boolean\> | 以Promise形式返回检查蜂窝数据业务是否启用漫游。<br />true：蜂窝数据业务已启用漫游。<br />false：蜂窝数据业务已禁用漫游。 | 404 405**错误码：** 406 407以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 408 409| 错误码ID | 错误信息 | 410| -------- | -------------------------------------------- | 411| 201 | Permission denied. | 412| 401 | Parameter error. | 413| 8300001 | Invalid parameter value. | 414| 8300002 | Operation failed. Cannot connect to service. | 415| 8300003 | System internal error. | 416| 8300999 | Unknown error code. | 417 418**示例：** 419 420```js 421let promise = data.isCellularDataRoamingEnabled(0); 422promise.then((data) => { 423 console.log(`test success, promise: data->${JSON.stringify(data)}`); 424}).catch((err) => { 425 console.error(`test fail, promise: err->${JSON.stringify(err)}`); 426}); 427``` 428 429## data.enableCellularData 430 431enableCellularData(callback: AsyncCallback<void\>): void 432 433启用蜂窝数据服务，使用callback方式作为异步方法。 434 435**系统接口：** 此接口为系统接口。 436 437**需要权限**：ohos.permission.SET_TELEPHONY_STATE 438 439**系统能力**：SystemCapability.Telephony.CellularData 440 441**参数：** 442 443| 参数名 | 类型 | 必填 | 说明 | 444| -------- | --------------------- | ---- | ---------- | 445| callback | AsyncCallback\<void\> | 是 | 回调函数。 | 446 447**错误码：** 448 449以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 450 451| 错误码ID | 错误信息 | 452| -------- | -------------------------------------------- | 453| 201 | Permission denied. | 454| 401 | Parameter error. | 455| 8300001 | Invalid parameter value. | 456| 8300002 | Operation failed. Cannot connect to service. | 457| 8300003 | System internal error. | 458| 8300999 | Unknown error code. | 459 460**示例：** 461 462```js 463data.enableCellularData((err) => { 464 console.log(`callback: err->${JSON.stringify(err)}`); 465}); 466``` 467 468## data.enableCellularData 469 470enableCellularData(): Promise<void\> 471 472启用蜂窝数据服务，使用Promise方式作为异步方法。 473 474**系统接口：** 此接口为系统接口。 475 476**需要权限**：ohos.permission.SET_TELEPHONY_STATE 477 478**系统能力**：SystemCapability.Telephony.CellularData 479 480**返回值：** 481 482| 类型 | 说明 | 483| --------------- | ----------------------- | 484| Promise\<void\> | 以Promise形式返回结果。 | 485 486**错误码：** 487 488以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 489 490| 错误码ID | 错误信息 | 491| -------- | -------------------------------------------- | 492| 201 | Permission denied. | 493| 401 | Parameter error. | 494| 8300001 | Invalid parameter value. | 495| 8300002 | Operation failed. Cannot connect to service. | 496| 8300003 | System internal error. | 497| 8300999 | Unknown error code. | 498 499**示例：** 500 501```js 502let promise = data.enableCellularData(); 503promise.then(() => { 504 console.log(`enableCellularData success.`); 505}).catch((err) => { 506 console.error(`enableCellularData fail, promise: err->${JSON.stringify(err)}`); 507}); 508``` 509 510## data.disableCellularData 511 512disableCellularData(callback: AsyncCallback<void\>): void 513 514禁用蜂窝数据服务，使用callback方式作为异步方法。 515 516**系统接口：** 此接口为系统接口。 517 518**需要权限**：ohos.permission.SET_TELEPHONY_STATE 519 520**系统能力**：SystemCapability.Telephony.CellularData 521 522**参数：** 523 524| 参数名 | 类型 | 必填 | 说明 | 525| -------- | --------------------- | ---- | ---------- | 526| callback | AsyncCallback\<void\> | 是 | 回调函数。 | 527 528**错误码：** 529 530以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 531 532| 错误码ID | 错误信息 | 533| -------- | -------------------------------------------- | 534| 201 | Permission denied. | 535| 401 | Parameter error. | 536| 8300001 | Invalid parameter value. | 537| 8300002 | Operation failed. Cannot connect to service. | 538| 8300003 | System internal error. | 539| 8300999 | Unknown error code. | 540 541**示例：** 542 543```js 544data.disableCellularData((err) => { 545 console.log(`callback: err->${JSON.stringify(err)}`); 546}); 547``` 548 549## data.disableCellularData 550 551disableCellularData(): Promise<void\> 552 553禁用蜂窝数据服务，使用Promise方式作为异步方法。 554 555**系统接口：** 此接口为系统接口。 556 557**需要权限**：ohos.permission.SET_TELEPHONY_STATE 558 559**系统能力**：SystemCapability.Telephony.CellularData 560 561**返回值：** 562 563| 类型 | 说明 | 564| --------------- | --------------------------- | 565| Promise\<void\> | 以Promise形式返回禁用结果。 | 566 567**错误码：** 568 569以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 570 571| 错误码ID | 错误信息 | 572| -------- | -------------------------------------------- | 573| 201 | Permission denied. | 574| 401 | Parameter error. | 575| 8300001 | Invalid parameter value. | 576| 8300002 | Operation failed. Cannot connect to service. | 577| 8300003 | System internal error. | 578| 8300999 | Unknown error code. | 579 580**示例：** 581 582```js 583let promise = data.disableCellularData(); 584promise.then(() => { 585 console.log(`disableCellularData success.`); 586}).catch((err) => { 587 console.error(`disableCellularData fail, promise: err->${JSON.stringify(err)}`); 588}); 589``` 590 591## data.enableCellularDataRoaming 592 593enableCellularDataRoaming(slotId: number, callback: AsyncCallback<void\>): void 594 595启用蜂窝数据漫游，使用callback方式作为异步方法。 596 597**系统接口：** 此接口为系统接口。 598 599**需要权限**：ohos.permission.SET_TELEPHONY_STATE 600 601**系统能力**：SystemCapability.Telephony.CellularData 602 603**参数：** 604 605| 参数名 | 类型 | 必填 | 说明 | 606| -------- | --------------------- | ---- | ---------------------------------------- | 607| slotId | number | 是 | 卡槽ID。<br />0：卡槽1。<br />1：卡槽2。 | 608| callback | AsyncCallback\<void\> | 是 | 回调函数。 | 609 610**错误码：** 611 612以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 613 614| 错误码ID | 错误信息 | 615| -------- | -------------------------------------------- | 616| 201 | Permission denied. | 617| 401 | Parameter error. | 618| 8300001 | Invalid parameter value. | 619| 8300002 | Operation failed. Cannot connect to service. | 620| 8300003 | System internal error. | 621| 8300999 | Unknown error code. | 622 623**示例：** 624 625```js 626data.enableCellularDataRoaming(0, (err) => { 627 console.log(`callback: err->${JSON.stringify(err)}`); 628}); 629``` 630 631## data.enableCellularDataRoaming 632 633enableCellularDataRoaming(slotId: number): Promise<void\> 634 635启用蜂窝数据漫游，使用Promise方式作为异步方法。 636 637**系统接口：** 此接口为系统接口。 638 639**需要权限**：ohos.permission.SET_TELEPHONY_STATE 640 641**系统能力**：SystemCapability.Telephony.CellularData 642 643**参数：** 644 645| 参数名 | 类型 | 必填 | 说明 | 646| ------ | ------ | ---- | ---------------------------------------- | 647| slotId | number | 是 | 卡槽ID。<br />0：卡槽1。<br />1：卡槽2。 | 648 649**返回值：** 650 651| 类型 | 说明 | 652| --------------- | ------------------------- | 653| Promise\<void\> | 以Promise形式返回启用结果 | 654 655**错误码：** 656 657以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 658 659| 错误码ID | 错误信息 | 660| -------- | -------------------------------------------- | 661| 201 | Permission denied. | 662| 401 | Parameter error. | 663| 8300001 | Invalid parameter value. | 664| 8300002 | Operation failed. Cannot connect to service. | 665| 8300003 | System internal error. | 666| 8300999 | Unknown error code. | 667 668**示例：** 669 670```js 671let promise = data.enableCellularDataRoaming(0); 672promise.then(() => { 673 console.log(`enableCellularDataRoaming success.`); 674}).catch((err) => { 675 console.error(`enableCellularDataRoaming fail, promise: err->${JSON.stringify(err)}`); 676}); 677``` 678 679## data.disableCellularDataRoaming 680 681disableCellularDataRoaming(slotId: number, callback: AsyncCallback<void\>): void 682 683禁用蜂窝数据漫游，使用callback方式作为异步方法。 684 685**系统接口：** 此接口为系统接口。 686 687**需要权限**：ohos.permission.SET_TELEPHONY_STATE 688 689**系统能力**：SystemCapability.Telephony.CellularData 690 691**参数：** 692 693| 参数名 | 类型 | 必填 | 说明 | 694| -------- | --------------------- | ---- | ---------------------------------------- | 695| slotId | number | 是 | 卡槽ID。<br />0：卡槽1。<br />1：卡槽2。 | 696| callback | AsyncCallback\<void\> | 是 | 回调函数。 | 697 698**错误码：** 699 700以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 701 702| 错误码ID | 错误信息 | 703| -------- | -------------------------------------------- | 704| 201 | Permission denied. | 705| 401 | Parameter error. | 706| 8300001 | Invalid parameter value. | 707| 8300002 | Operation failed. Cannot connect to service. | 708| 8300003 | System internal error. | 709| 8300999 | Unknown error code. | 710 711**示例：** 712 713```js 714data.disableCellularDataRoaming(0, (err) => { 715 console.log(`callback: err->${JSON.stringify(err)}`); 716}); 717``` 718 719## data.disableCellularDataRoaming 720 721disableCellularDataRoaming(slotId: number): Promise<void\> 722 723禁用蜂窝数据漫游，使用Promise方式作为异步方法。 724 725**系统接口：** 此接口为系统接口。 726 727**需要权限**：ohos.permission.SET_TELEPHONY_STATE 728 729**系统能力**：SystemCapability.Telephony.CellularData 730 731**参数：** 732 733| 参数名 | 类型 | 必填 | 说明 | 734| ------ | ------ | ---- | ---------------------------------------- | 735| slotId | number | 是 | 卡槽ID。<br />0：卡槽1。<br />1：卡槽2。 | 736 737**返回值：** 738 739| 类型 | 说明 | 740| --------------- | ------------------------- | 741| Promise\<void\> | 以Promise形式返回禁用结果 | 742 743**错误码：** 744 745以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 746 747| 错误码ID | 错误信息 | 748| -------- | -------------------------------------------- | 749| 201 | Permission denied. | 750| 401 | Parameter error. | 751| 8300001 | Invalid parameter value. | 752| 8300002 | Operation failed. Cannot connect to service. | 753| 8300003 | System internal error. | 754| 8300999 | Unknown error code. | 755 756**示例：** 757 758```js 759let promise = data.disableCellularDataRoaming(0); 760promise.then(() => { 761 console.log(`disableCellularDataRoaming success.`); 762}).catch((err) => { 763 console.error(`disableCellularDataRoaming fail, promise: err->${JSON.stringify(err)}`); 764}); 765``` 766 767## DataFlowType 768 769描述蜂窝数据流类型。 770 771**系统能力**：SystemCapability.Telephony.CellularData 772 773| 名称 | 值 | 说明 | 774| ---------------------- | ---- | ------------------------------------------ | 775| DATA_FLOW_TYPE_NONE | 0 | 表示没有上行或下行数据。 | 776| DATA_FLOW_TYPE_DOWN | 1 | 表示只有下行数据。 | 777| DATA_FLOW_TYPE_UP | 2 | 表示只有上行数据。 | 778| DATA_FLOW_TYPE_UP_DOWN | 3 | 表示有上下行数据。 | 779| DATA_FLOW_TYPE_DORMANT | 4 | 表示没有上下行数据，底层链路处于休眠状态。 | 780 781## DataConnectState 782 783描述蜂窝数据链路连接状态。 784 785**系统能力**：SystemCapability.Telephony.CellularData 786 787| 名称 | 值 | 说明 | 788| ----------------------- | ---- | -------------------------- | 789| DATA_STATE_UNKNOWN | -1 | 表示蜂窝数据链路未知。 | 790| DATA_STATE_DISCONNECTED | 0 | 表示蜂窝数据链路断开。 | 791| DATA_STATE_CONNECTING | 1 | 表示正在连接蜂窝数据链路。 | 792| DATA_STATE_CONNECTED | 2 | 表示蜂窝数据链路已连接。 | 793| DATA_STATE_SUSPENDED | 3 | 表示蜂窝数据链路被挂起。 | 794