tmui-cli 5.3.2 → 5.3.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (250) hide show
  1. package/data/components.json +1 -1
  2. package/data/config.json +1 -1
  3. package/data/doc-index.json +7 -2
  4. package/data/guides//345/201/234/346/255/242/345/205/254/345/221/212.md +29 -0
  5. package/data/guides//346/233/264/346/226/260/346/227/245/345/277/227.md +5 -1
  6. package/data/tmui4x/01./346/225/231/347/250/213/02./346/233/264/346/226/260/346/227/245/345/277/227.md +1214 -1183
  7. package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xCorrectS /346/226/207/346/241/243/346/240/241/346/255/243/344/270/216/350/257/206/345/210/253.md" +1 -1
  8. package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xOfficeU Office /346/226/207/346/241/243/347/274/226/350/276/221.md" +1 -1
  9. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/205/266/345/256/203/347/273/204/344/273/266//344/272/214/347/273/264/347/240/201 xQrcoder.md" +1 -1
  10. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/205/266/345/256/203/347/273/204/344/273/266//345/212/250/347/224/273 xAnimation.md" +1 -1
  11. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/205/266/345/256/203/347/273/204/344/273/266//345/216/237/347/224/237/345/233/276/350/241/250 Chart.md" +1 -1
  12. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/205/266/345/256/203/347/273/204/344/273/266//345/233/276/347/211/207/350/243/201/345/211/252 xImageResizer.md" +3 -3
  13. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/205/266/345/256/203/347/273/204/344/273/266//345/233/276/350/241/250 xEchart.md" +2 -2
  14. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/205/266/345/256/203/347/273/204/344/273/266//345/256/211/345/205/250/351/252/214/350/257/201 xSafeVerify.md" +1 -1
  15. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/205/266/345/256/203/347/273/204/344/273/266//346/200/235/347/273/264/345/257/274/345/233/276 xTreeFlat.md" +1 -1
  16. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/205/266/345/256/203/347/273/204/344/273/266//346/211/213/345/212/277/345/272/223 xFinger.md" +1 -1
  17. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/205/266/345/256/203/347/273/204/344/273/266//346/217/220/345/217/212 xMention.md" +1 -1
  18. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/205/266/345/256/203/347/273/204/344/273/266//346/235/241/347/240/201 xBarcode.md" +1 -1
  19. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/205/266/345/256/203/347/273/204/344/273/266//346/273/221/345/212/250/351/252/214/350/257/201 xSlideVerify.md" +1 -1
  20. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/205/266/345/256/203/347/273/204/344/273/266//347/255/276/345/220/215/346/235/277 xSignBoard.md" +1 -1
  21. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/205/266/345/256/203/347/273/204/344/273/266//351/242/234/350/211/262/351/200/211/346/213/251 xColorView.md" +1 -1
  22. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/205/266/345/256/203/347/273/204/344/273/266//351/252/214/350/257/201/347/240/201/350/276/223/345/205/245/346/241/206 xCodeInput.md" +1 -1
  23. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/217/215/351/246/210/347/273/204/344/273/266//344/270/213/346/213/211/345/210/267/346/226/260 xPullRefresh.md" +1 -1
  24. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/217/215/351/246/210/347/273/204/344/273/266//344/270/213/346/213/211/350/217/234/345/215/225 xDropdownMenu.md" +1 -1
  25. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/217/215/351/246/210/347/273/204/344/273/266//344/270/213/346/213/211/350/217/234/345/215/225/345/255/220/347/273/204/344/273/266 xDropdownItem.md" +1 -1
  26. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/217/215/351/246/210/347/273/204/344/273/266//345/212/240/350/275/275/344/270/255 xLoading.md" +1 -1
  27. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/217/215/351/246/210/347/273/204/344/273/266//345/212/250/344/275/234/350/217/234/345/215/225/351/235/242/346/235/277 xActionMenu.md" +1 -1
  28. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/217/215/351/246/210/347/273/204/344/273/266//345/257/271/350/257/235/346/241/206 xModal.md" +1 -1
  29. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/217/215/351/246/210/347/273/204/344/273/266//345/267/246/346/273/221/350/217/234/345/215/225 xSwitchSlider.md" +1 -1
  30. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/217/215/351/246/210/347/273/204/344/273/266//345/272/225/351/203/250/345/257/271/350/257/235/346/241/206 xActionModal.md" +1 -1
  31. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/217/215/351/246/210/347/273/204/344/273/266//345/274/271/345/271/225 Barrage.md" +1 -1
  32. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/217/215/351/246/210/347/273/204/344/273/266//345/274/271/345/271/225/345/255/220/350/212/202/347/202/271 xBarrageItem.md" +1 -1
  33. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/217/215/351/246/210/347/273/204/344/273/266//346/212/275/345/261/211 xDrawer.md" +1 -1
  34. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/217/215/351/246/210/347/273/204/344/273/266//346/213/226/346/213/275/346/216/222/345/272/217 xDrag.md" +1 -1
  35. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/217/215/351/246/210/347/273/204/344/273/266//346/213/226/346/213/275/346/216/222/345/272/217/345/255/220/347/273/204/344/273/266 xDragItem.md" +1 -1
  36. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/217/215/351/246/210/347/273/204/344/273/266//346/261/275/346/263/241/350/217/234/345/215/225 xPopover.md" +1 -1
  37. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/217/215/351/246/210/347/273/204/344/273/266//346/265/256/345/212/250/351/235/242/346/235/277 FloatDrawer.md" +1 -1
  38. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/217/215/351/246/210/347/273/204/344/273/266//346/265/256/347/220/203 xFloatButton.md" +1 -1
  39. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/217/215/351/246/210/347/273/204/344/273/266//346/266/210/346/201/257/346/235/241 xSnackbar.md" +1 -1
  40. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/217/215/351/246/210/347/273/204/344/273/266//346/266/210/346/201/257/346/235/241/345/255/220/350/212/202/347/202/271 xSnackbarItem.md" +1 -1
  41. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/217/215/351/246/210/347/273/204/344/273/266//346/266/210/346/201/257/351/200/232/347/237/245 xMsgNotice.md" +1 -1
  42. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/217/215/351/246/210/347/273/204/344/273/266//351/201/256/347/275/251 xOverlay.md" +1 -1
  43. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/257/274/350/210/252/347/273/204/344/273/266//344/276/247/350/276/271/345/210/206/347/261/273 xSliderTree.md" +1 -1
  44. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/257/274/350/210/252/347/273/204/344/273/266//344/276/247/350/276/271/345/210/206/347/261/273/345/255/220/350/212/202/347/202/271 xSliderTreeChildren.md" +1 -1
  45. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/257/274/350/210/252/347/273/204/344/273/266//344/276/247/350/276/271/350/217/234/345/215/225 xSliderMenu.md" +1 -1
  46. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/257/274/350/210/252/347/273/204/344/273/266//345/215/225/351/200/211/346/214/211/351/222/256/347/273/204 xRadioButton.md" +1 -1
  47. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/257/274/350/210/252/347/273/204/344/273/266//345/256/253/346/240/274 xGrid.md" +1 -1
  48. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/257/274/350/210/252/347/273/204/344/273/266//345/256/253/346/240/274/345/255/220/347/273/204/344/273/266 xGridItem.md" +1 -1
  49. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/257/274/350/210/252/347/273/204/344/273/266//345/272/225/351/203/250/345/257/274/350/210/252 xTabbar.md" +1 -1
  50. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/257/274/350/210/252/347/273/204/344/273/266//345/274/225/345/257/274 xGuid.md" +1 -1
  51. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/257/274/350/210/252/347/273/204/344/273/266//345/274/225/345/257/274/345/255/220/347/273/204/344/273/266 xGuidItem.md" +1 -1
  52. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/257/274/350/210/252/347/273/204/344/273/266//346/220/234/347/264/242/346/240/217 xSearch.md" +1 -1
  53. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/257/274/350/210/252/347/273/204/344/273/266//346/227/266/351/227/264/345/221/250 xWeekbar.md" +1 -1
  54. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/257/274/350/210/252/347/273/204/344/273/266//346/240/207/347/255/276/345/257/274/350/210/252 xTabs.md" +1 -1
  55. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/257/274/350/210/252/347/273/204/344/273/266//346/240/207/351/242/230/345/257/274/350/210/252 xNavbar.md" +1 -1
  56. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/257/274/350/210/252/347/273/204/344/273/266//347/262/230/346/200/247/345/270/203/345/261/200 Sticky.md" +1 -1
  57. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/257/274/350/210/252/347/273/204/344/273/266//347/264/242/345/274/225 xIndexbar.md" +1 -1
  58. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/257/274/350/210/252/347/273/204/344/273/266//350/277/224/345/233/236/351/241/266/351/203/250 xBacktop.md" +1 -1
  59. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266/markdown xCmarkdown.md" +1 -1
  60. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//345/200/222/350/256/241/346/227/266 xCountdown.md" +1 -1
  61. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//345/210/206/345/211/262/347/272/277 xDivider.md" +1 -1
  62. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//345/210/227/350/241/250 xCell.md" +1 -1
  63. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//345/212/250/346/200/201/345/205/250/345/261/217 xViewTofull.md" +1 -1
  64. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//345/215/241/347/211/207 xCard.md" +1 -1
  65. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//345/233/276/347/211/207 xImage.md" +1 -1
  66. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//345/233/276/351/233/206 xImageGroup.md" +1 -1
  67. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//345/234/206/345/275/242/350/277/233/345/272/246/347/216/257 xCircleProgress.md" +1 -1
  68. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//345/244/264/345/203/217/347/273/204 xAvatarGroup.md" +1 -1
  69. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//345/257/214/346/226/207/346/234/254 xHtml.md" +3 -3
  70. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//345/257/214/346/226/207/346/234/254/345/255/220/347/273/204/344/273/266 xHtmlNode.md" +3 -3
  71. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//346/212/230/345/217/240/351/235/242/346/235/277 xCollapse.md" +1 -1
  72. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//346/212/230/345/217/240/351/235/242/346/235/277/345/255/220/347/273/204/344/273/266 xCollapseItem.md" +1 -1
  73. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//346/225/260/345/255/227/347/277/273/346/273/232 xRollingNumber.md" +1 -1
  74. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//346/237/245/347/234/213/346/233/264/345/244/232 xMore.md" +1 -1
  75. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//346/250/252/345/220/221/346/273/232/345/212/250 xScrollx.md" +1 -1
  76. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//346/255/245/351/252/244/346/235/241 xSteps.md" +1 -1
  77. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//346/255/245/351/252/244/346/235/241/345/255/220/347/273/204/344/273/266 xStepsItem.md" +1 -1
  78. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//346/260/264/345/215/260 xWatermark.md" +1 -1
  79. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//347/200/221/345/270/203/346/265/201 xWaterfall.md" +1 -1
  80. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//347/251/272/347/212/266/346/200/201 xEmpty.md" +1 -1
  81. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//350/231/232/346/213/237/345/210/227/350/241/250 xVirtualList.md" +1 -1
  82. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//350/241/250/346/240/274 xTable.md" +1 -1
  83. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//350/241/250/346/240/274/345/210/227 xTableCol.md" +1 -1
  84. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//350/247/222/346/240/207 xBadge.md" +1 -1
  85. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//350/255/246/345/221/212 xAlert.md" +1 -1
  86. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//350/257/215/344/272/221 xTextCloud.md" +8 -3
  87. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//350/277/233/345/272/246/346/235/241 xProgress.md" +1 -1
  88. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//351/200/232/347/237/245/346/240/217 xNotice.md" +1 -1
  89. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//351/207/221/351/242/235/346/240/205/346/240/274 xMoney.md" +1 -1
  90. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//351/223/276/346/216/245 xLink.md" +1 -1
  91. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//351/252/250/346/236/266/345/261/217 xSkeleton.md" +1 -1
  92. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/270/270/347/224/250/347/273/204/344/273/266//345/223/215/345/272/224/345/274/217/345/270/203/345/261/200 xLayout.md" +15 -25
  93. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/270/270/347/224/250/347/273/204/344/273/266//345/233/276/346/240/207 xIcon.md" +1 -1
  94. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/270/270/347/224/250/347/273/204/344/273/266//345/256/271/345/231/250 xSheet.md" +1 -1
  95. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/270/270/347/224/250/347/273/204/344/273/266//345/270/203/345/261/200 xRow.md" +1 -1
  96. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/270/270/347/224/250/347/273/204/344/273/266//345/270/203/345/261/200/345/255/220/347/273/204/344/273/266 xCol.md" +1 -1
  97. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/270/270/347/224/250/347/273/204/344/273/266//346/214/211/351/222/256 xButton.md" +74 -72
  98. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/270/270/347/224/250/347/273/204/344/273/266//346/226/207/346/234/254 xText.md" +1 -1
  99. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/270/270/347/224/250/347/273/204/344/273/266//346/240/207/347/255/276 xTag.md" +1 -1
  100. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//345/215/225/346/273/221/345/235/227 xSlider.md" +1 -1
  101. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//345/215/225/351/200/211/346/241/206 xRadio.md" +1 -1
  102. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//345/215/225/351/200/211/346/241/206/347/273/204 xRadioGroup.md" +1 -1
  103. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//345/217/214/345/220/221/346/273/221/345/235/227 xSliderDouble.md" +1 -1
  104. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//345/233/276/347/211/207/344/270/212/344/274/240 xUploadMedia.md" +1 -1
  105. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//345/237/216/345/270/202/351/200/211/346/213/251/345/231/250 xPickerCity.md" +1 -1
  106. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//345/244/232/351/200/211/346/227/245/345/216/206 xCalendarMultiple.md" +1 -1
  107. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//345/244/232/351/200/211/346/241/206 xCheckbox.md" +1 -1
  108. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//345/244/232/351/200/211/346/241/206/347/273/204 xCheckboxGroup.md" +1 -1
  109. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//345/257/206/347/240/201/351/224/256/347/233/230 xKeyboard.md" +1 -1
  110. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//345/257/214/346/226/207/346/234/254/347/274/226/350/276/221/345/231/250 xEditor.md" +1 -1
  111. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//345/265/214/345/205/245/345/274/217/346/227/245/346/234/237/351/200/211/346/213/251/345/231/250 xDateView.md" +1 -1
  112. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//345/274/200/345/205/263 xSwitch.md" +1 -1
  113. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//346/220/234/347/264/242/351/200/211/346/213/251 xpickerSelected.md" +1 -1
  114. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//346/225/260/345/255/227/351/224/256/347/233/230 xKeyboardNumber.md" +1 -1
  115. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//346/226/207/344/273/266/351/200/211/346/213/251 xUploadFile.md" +1 -1
  116. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//346/227/245/345/216/206 xCalendar.md" +1 -1
  117. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//346/227/245/346/234/237/351/200/211/346/213/251/345/231/250 xPickerDate.md" +1 -1
  118. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//346/227/266/351/227/264/345/214/272/351/227/264/351/200/211/346/213/251 xBetweenTime.md" +1 -1
  119. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//346/227/266/351/227/264/351/200/211/346/213/251/345/231/250 xPickerTime.md" +1 -1
  120. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//346/236/201/350/201/224/345/231/250 xCascader.md" +1 -1
  121. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//346/240/207/347/255/276/350/276/223/345/205/245/346/241/206 xInputTag.md" +1 -1
  122. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//346/240/221 xTree.md" +1 -1
  123. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//346/255/245/350/277/233/345/231/250 xStepper.md" +1 -1
  124. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//347/277/273/351/241/265/345/231/250 xPagination.md" +1 -1
  125. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//350/241/250/345/215/225 xForm.md" +139 -3
  126. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//350/241/250/345/215/225/345/255/220/347/273/204/344/273/266 xFormItem.md" +139 -4
  127. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//350/257/204/345/210/206 xRate.md" +1 -1
  128. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//350/272/253/344/273/275/350/257/201/351/224/256/347/233/230 xKeyboardIdcard.md" +1 -1
  129. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//350/275/246/347/211/214/351/224/256/347/233/230 xKeyboardCar.md" +1 -1
  130. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//350/276/223/345/205/245/346/241/206 xInput.md" +2 -2
  131. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//350/276/223/345/205/245/346/241/206 xInputNumber.md" +1 -1
  132. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//351/200/211/346/213/251/345/231/250 xPicker.md" +1 -1
  133. package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//351/200/211/346/213/251/345/231/250/345/256/271/345/231/250 xPickerView.md" +1 -1
  134. package/data/tmui4x/60.AI/350/207/252/345/212/250/345/214/226/06.tokens/350/207/252/347/224/261.md +2 -6
  135. package/data/tmui4x-doc-index.json +1 -1
  136. package/data/uni-app-x-docs/.vuepress/utils/customTypeJson.json +1 -1
  137. package/data/uni-app-x-docs/.vuepress/utils/utsApiJson.json +1 -1
  138. package/data/uni-app-x-docs/.vuepress/utils/utsComJson.json +1 -1
  139. package/data/uni-app-x-docs/.vuepress/utils/utsJson.json +1 -1
  140. package/data/uni-app-x-docs/_sidebar.md +1 -0
  141. package/data/uni-app-x-docs/api/_sidebar.md +3 -0
  142. package/data/uni-app-x-docs/api/bluetooth-general.md +280 -0
  143. package/data/uni-app-x-docs/api/bluetooth-le-central.md +376 -0
  144. package/data/uni-app-x-docs/api/keyboard.md +6 -0
  145. package/data/uni-app-x-docs/api/memory.md +1 -1
  146. package/data/uni-app-x-docs/api/scrollviewcontext.md +111 -0
  147. package/data/uni-app-x-docs/api/unicloud/README.md +1 -1
  148. package/data/uni-app-x-docs/app-vapor.md +2 -41
  149. package/data/uni-app-x-docs/collocation/manifest-android.md +1 -1
  150. package/data/uni-app-x-docs/component/_sidebar.md +2 -1
  151. package/data/uni-app-x-docs/component/common.md +48 -2
  152. package/data/uni-app-x-docs/component/datacom.md +823 -0
  153. package/data/uni-app-x-docs/component/input.md +2 -2
  154. package/data/uni-app-x-docs/component/label.md +1 -1
  155. package/data/uni-app-x-docs/component/map.md +12 -12
  156. package/data/uni-app-x-docs/component/text.md +7 -3
  157. package/data/uni-app-x-docs/component/textarea.md +2 -6
  158. package/data/uni-app-x-docs/component/uni-ui-x/uni-expandable-text.md +22 -0
  159. package/data/uni-app-x-docs/component/web-view.md +65 -0
  160. package/data/uni-app-x-docs/css/common/style-isolation.md +8 -0
  161. package/data/uni-app-x-docs/css/word-break.md +3 -0
  162. package/data/uni-app-x-docs/native/download/android.md +83 -103
  163. package/data/uni-app-x-docs/native/download/ios.md +10 -10
  164. package/data/uni-app-x-docs/readme.md +2 -1
  165. package/data/uni-app-x-docs/release-note-alpha.md +39 -0
  166. package/data/uni-app-x-docs/release.md +144 -1
  167. package/data/uni-app-x-docs/sample.md +15 -12
  168. package/data/uni-app-x-docs/static/bluetooth-general-flow.svg +69 -0
  169. package/data/uni-app-x-docs/static/bluetooth-le-central-flow.svg +102 -0
  170. package/data/uniappx/_sidebar.md +1 -0
  171. package/data/uniappx/api/_sidebar.md +3 -0
  172. package/data/uniappx/api/app-route.md +10 -10
  173. package/data/uniappx/api/bluetooth-general.md +822 -0
  174. package/data/uniappx/api/bluetooth-le-central.md +1044 -0
  175. package/data/uniappx/api/calendar.md +4 -4
  176. package/data/uniappx/api/compress-image.md +1 -1
  177. package/data/uniappx/api/contact.md +0 -4
  178. package/data/uniappx/api/convert2-abs-full-path.md +4 -0
  179. package/data/uniappx/api/create-canvas-context-async.md +0 -4
  180. package/data/uniappx/api/create-inner-audio-context.md +1 -1
  181. package/data/uniappx/api/get-app-base-info.md +1 -1
  182. package/data/uniappx/api/get-location.md +2 -2
  183. package/data/uniappx/api/get-recorder-manager.md +1 -1
  184. package/data/uniappx/api/get-video-info.md +1 -1
  185. package/data/uniappx/api/gyroscope.md +8 -8
  186. package/data/uniappx/api/install-wgt.md +4 -0
  187. package/data/uniappx/api/keyboard.md +6 -0
  188. package/data/uniappx/api/loading.md +2 -2
  189. package/data/uniappx/api/memory.md +1 -1
  190. package/data/uniappx/api/modal.md +1 -1
  191. package/data/uniappx/api/preview-image.md +4 -4
  192. package/data/uniappx/api/report.md +0 -4
  193. package/data/uniappx/api/request-system-permission.md +2 -2
  194. package/data/uniappx/api/screen-brightness.md +6 -6
  195. package/data/uniappx/api/scrollviewcontext.md +3 -0
  196. package/data/uniappx/api/toast.md +2 -2
  197. package/data/uniappx/api/uasm.md +4 -4
  198. package/data/uniappx/api/unicloud/README.md +1 -1
  199. package/data/uniappx/api/uniresizeobserver.md +144 -27
  200. package/data/uniappx/api/vibrate.md +8 -0
  201. package/data/uniappx/app-vapor.md +2 -41
  202. package/data/uniappx/collocation/manifest-android.md +1 -1
  203. package/data/uniappx/component/_sidebar.md +2 -1
  204. package/data/uniappx/component/animation-view.md +2 -2
  205. package/data/uniappx/component/camera.md +1 -1
  206. package/data/uniappx/component/canvas.md +2 -2
  207. package/data/uniappx/component/common.md +48 -1
  208. package/data/uniappx/component/datacom.md +683 -0
  209. package/data/uniappx/component/editor.md +1 -1
  210. package/data/uniappx/component/image.md +1 -1
  211. package/data/uniappx/component/input.md +2 -2
  212. package/data/uniappx/component/label.md +1 -1
  213. package/data/uniappx/component/map.md +12 -12
  214. package/data/uniappx/component/progress.md +3 -3
  215. package/data/uniappx/component/radio.md +1 -1
  216. package/data/uniappx/component/rich-text.md +3 -3
  217. package/data/uniappx/component/swiper.md +1 -1
  218. package/data/uniappx/component/switch.md +2 -2
  219. package/data/uniappx/component/text.md +9 -5
  220. package/data/uniappx/component/textarea.md +2 -6
  221. package/data/uniappx/component/uni-ui-x/README.md +21 -19
  222. package/data/uniappx/component/uni-ui-x/uni-collapse.md +8 -0
  223. package/data/uniappx/component/uni-ui-x/uni-combox.md +19 -0
  224. package/data/uniappx/component/uni-ui-x/uni-drag-cell.md +4 -0
  225. package/data/uniappx/component/uni-ui-x/uni-expandable-text.md +120 -0
  226. package/data/uniappx/component/uni-ui-x/uni-fab-button.md +4 -0
  227. package/data/uniappx/component/uni-ui-x/uni-icons.md +60 -18
  228. package/data/uniappx/component/uni-ui-x/uni-index-bar.md +4 -0
  229. package/data/uniappx/component/uni-ui-x/uni-link.md +4 -0
  230. package/data/uniappx/component/uni-ui-x/uni-nav-bar.md +4 -0
  231. package/data/uniappx/component/uni-ui-x/uni-number-box.md +4 -0
  232. package/data/uniappx/component/uni-ui-x/uni-rate.md +2 -2
  233. package/data/uniappx/component/uni-ui-x/uni-refresh-box.md +4 -0
  234. package/data/uniappx/component/uni-ui-x/uni-tab.md +16 -0
  235. package/data/uniappx/component/uni-ui-x/uni-time-format.md +4 -0
  236. package/data/uniappx/component/view.md +1 -1
  237. package/data/uniappx/component/waterflow.md +1 -1
  238. package/data/uniappx/component/web-view.md +54 -1
  239. package/data/uniappx/css/common/style-isolation.md +8 -0
  240. package/data/uniappx/css/word-break.md +3 -0
  241. package/data/uniappx/native/download/android.md +80 -100
  242. package/data/uniappx/native/download/ios.md +10 -10
  243. package/data/uniappx/readme.md +2 -1
  244. package/data/uniappx/release-note-alpha.md +39 -0
  245. package/data/uniappx/release.md +143 -0
  246. package/data/uniappx/sample.md +15 -12
  247. package/data/uniappx/uts/buildin-object-api/global.md +2 -2
  248. package/data/uniappx/uts/buildin-object-api/utsjsonobject.md +4 -0
  249. package/data/uniappx-doc-index.json +99 -25
  250. package/package.json +1 -1
package/data/uniappx/api/bluetooth-general.md ADDED
@@ -0,0 +1,822 @@
1
+ ::: warning 注意事项
2
+
3
+ 使用蓝牙能力前，需先调用 [uni.openBluetoothAdapter](#openbluetoothadapter) 初始化蓝牙适配器，并确认初始化成功。调用 [uni.closeBluetoothAdapter](#closebluetoothadapter) 或应用进程结束后，再次使用时需重新初始化。监听类接口可提前注册。
4
+
5
+ ## 模块介绍
6
+
7
+ 蓝牙规范由蓝牙技术联盟（SIG）制定，主流有两种规格：**经典蓝牙（BR/EDR）** 用于音箱、耳机等较大带宽场景；**蓝牙低功耗（BLE，蓝牙 4.0 起）** 功耗低、适合小数据量传输，常见于智能穿戴、传感器、智能家居等设备。
8
+
9
+ 本文与[蓝牙-低功耗中心设备](./bluetooth-le-central.md)介绍 BLE 中心设备能力，用于发现并连接蓝牙低功耗外设，不用于经典蓝牙设备的数据通信。接口按职责分为两部分：
10
+
11
+ - **蓝牙-通用**：初始化/关闭适配器、监听适配器状态、扫描与发现设备、获取设备列表；
12
+ - **[蓝牙-低功耗中心设备](./bluetooth-le-central.md)**：连接设备、发现服务与特征值、读写特征值、订阅通知、MTU 等。
13
+
14
+ 当前支持微信小程序（uni-app x 4.41 起）和支付宝小程序（uni-app x 5.31 起），App 端暂不支持。各接口的具体支持范围及最低支持版本以兼容性表为准。
15
+
16
+ ## 使用流程
17
+
18
+ <a href="../static/bluetooth-general-flow.svg" target="_blank" rel="noopener"></a>
19
+
20
+ 1. 注册 [uni.onBluetoothAdapterStateChange](#onbluetoothadapterstatechange) 和 [uni.onBluetoothDeviceFound](#onbluetoothdevicefound)，分别监听适配器状态和设备发现事件。
21
+ 2. 调用 [uni.openBluetoothAdapter](#openbluetoothadapter)，初始化成功后调用 [uni.startBluetoothDevicesDiscovery](#startbluetoothdevicesdiscovery) 开始扫描。
22
+ 3. 通过设备发现事件获取目标设备的 `deviceId`，也可调用 [uni.getBluetoothDevices](#getbluetoothdevices) 获取已发现的设备列表。
23
+ 4. 发现目标设备后，调用 [uni.stopBluetoothDevicesDiscovery](#stopbluetoothdevicesdiscovery) 停止扫描，再连接设备并通信，见[蓝牙-低功耗中心设备](./bluetooth-le-central.md)。
24
+ 5. 使用结束后，移除当前页面或组件注册的监听；不再使用蓝牙能力时，调用 [uni.closeBluetoothAdapter](#closebluetoothadapter) 释放适配器。
25
+
26
+ ## 权限@permission
27
+
28
+ ### iOS
29
+
30
+ - 蓝牙访问需要 `NSBluetoothAlwaysUsageDescription` 隐私说明，并获得用户授权。发行时应确认最终应用包含符合实际用途的权限说明。
31
+ - 系统蓝牙开关与应用蓝牙权限是两个独立条件。系统蓝牙已开启，不代表应用已获授权。
32
+
33
+ ### 微信小程序和支付宝小程序
34
+
35
+ 需分别遵循微信小程序和支付宝小程序的蓝牙授权要求与平台限制。各接口的支持范围以对应的兼容性表为准。
36
+
37
+ ## 注意事项@tips
38
+
39
+ ### 设备发现与连接
40
+
41
+ - **使用扫描返回的 deviceId**：通过设备发现事件或已发现的设备列表获取目标设备的 `deviceId`，再用于后续连接和通信。
42
+ - **iOS 设备标识**：连接设备前需先扫描发现设备，仅保存设备 ID 不能代替设备发现。iOS 的 `deviceId` 来自系统分配的 UUID，不应假设它跨手机、跨安装或跨会话始终不变。
43
+ - **及时停止扫描**：扫描较耗电，发现目标设备后应尽快停止扫描。
44
+
45
+ 适配器可用不代表设备已连接。监听设备连接状态时，使用 [uni.onBLEConnectionStateChange](./bluetooth-le-central.md#onbleconnectionstatechange)，通过回调中的 `deviceId` 和 `connected` 判断目标设备是否连接。
46
+
47
+ ### 事件监听
48
+
49
+ - **监听与取消监听成对使用**：页面或组件卸载时，调用对应的 `off*` 移除自身注册的监听，避免重复监听或影响其他页面。
50
+ - **iOS 监听 ID**：可保存 `on*` 返回的监听 ID，并将该 ID 传给对应的 `off*`，仅移除自身注册的监听，避免清空其他页面的监听。
51
+
52
+ ### 适配器状态与权限
53
+
54
+ - **适配器由应用共享**：关闭适配器会影响其他页面正在进行的蓝牙操作，应统一管理其生命周期。
55
+ - **蓝牙关闭后的恢复**：系统蓝牙关闭后，现有扫描与连接会失效。重新开启后，应根据适配器可用状态重新扫描、连接，并重新发现服务与特征值、订阅通知。
56
+
57
+ 系统蓝牙开关和应用蓝牙权限需分别检查。先注册 [uni.onBluetoothAdapterStateChange](#onbluetoothadapterstatechange) 并调用 [uni.openBluetoothAdapter](#openbluetoothadapter) 初始化。
58
+
59
+ 以下操作路径及事件表现为 **iOS 平台差异**，不作为其他平台的操作说明：
60
+
61
+ | 操作路径 | 事件表现 | uni API 处理方式 |
62
+ | --- | --- | --- |
63
+ | 设置 → 蓝牙：主开关 | 应用进程存活时，会触发适配器状态变化事件 | 在 `onBluetoothAdapterStateChange` 回调中通过 `available` 判断是否可用。关闭时停止后续蓝牙操作；重新开启且 `available` 为 `true` 后，按需重新扫描和连接。 |
64
+ | 设置 → App → 蓝牙：应用权限 | 系统会终止 App，不能依赖原进程继续接收事件 | 重新启动后，重新注册监听并调用 `openBluetoothAdapter`，根据成功或失败回调处理授权结果。 |
65
+ | 控制中心：蓝牙按钮 | 通常不会触发适配器状态变化事件 | 适配器仍可能可用，不能用此操作代替系统蓝牙主开关测试。设备是否断开应通过 `onBLEConnectionStateChange` 判断。 |
66
+
67
+ ### 后台运行
68
+
69
+ iOS 应用进行后台蓝牙操作需声明 `bluetooth-central` 后台模式，但后台扫描与连接仍受系统调度限制，不能保证与前台行为一致。
70
+
71
+ ### 初始化失败处理
72
+
73
+ 以下错误码及处理方式适用于 App，微信小程序和支付宝小程序的错误码说明详见其文档。
74
+
75
+ | errCode | 含义 | 建议处理 |
76
+ | --- | --- | --- |
77
+ | `1509602` | 应用未获得蓝牙权限 | 引导用户在“设置 → App → 蓝牙”中授权。权限变更导致 App 重新启动后，重新注册监听并初始化。 |
78
+ | `1509603` | 系统蓝牙已关闭 | 引导用户在“设置 → 蓝牙”中开启主开关，恢复后重新调用初始化。 |
79
+ | `1500102` | 适配器暂不可用 | 等待适配器恢复可用后再尝试，不要连续反复初始化。 |
80
+ | `1509010` | 初始化时等待适配器状态超时 | 稍后重试初始化，并检查系统蓝牙状态；该错误不同于连接设备时的 `1509005`。 |
81
+ | `1500105` | 系统或平台不支持该蓝牙能力 | 检查接口兼容性及运行环境，重复调用不能消除此限制。 |
82
+ | `1500104` / `1509000` | 系统调用失败或其他错误 | 记录接口名、`errCode`、`errMsg` 及可用的错误详情，结合真机环境进一步排查。 |
83
+
84
+ ::: sourceCode
85
+ ## uni.openBluetoothAdapter(options) @openbluetoothadapter
86
+
87
+ 初始化蓝牙模块，建议与 uni.closeBluetoothAdapter 成对调用。
88
+
89
+ ### openBluetoothAdapter 兼容性
90
+ | Web | 微信小程序 | 支付宝小程序 | Android | iOS(VDOM) | iOS(Vapor) | HarmonyOS |
91
+ | :- | :- | :- | :- | :- | :- | :- |
92
+ | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.41 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 5.34 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> |
93
+
94
+ ### 参数
95
+
96
+ | 名称 | 类型 | 必填 | 兼容性 | 描述 |
97
+ | :- | :- | :- | :-: | :- |
98
+ | options | **OpenBluetoothAdapterOptions** | 是 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | * |
99
+ | 名称 | 类型 | 必备 | 兼容性 | 描述 |
100
+ | :- | :- | :- | :-: | :- |
101
+ | success | (result: [OpenBluetoothAdapterSuccess](#openbluetoothadaptersuccess-values)) => void | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 接口调用成功的回调函数。 |
102
+ | fail | (result: [BluetoothFail](#bluetoothfail-values)) => void | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 接口调用失败的回调函数。 |
103
+ | complete | (result: [OpenBluetoothAdapterSuccess](#openbluetoothadaptersuccess-values) \| [BluetoothFail](#bluetoothfail-values)) => void | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 接口调用结束的回调函数，调用成功、失败都会执行。 |
104
+ | mode | string | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | 需要基础库： `2.10.0`<br/><br/>蓝牙模式，可作为主/从设备，仅 iOS 需要。<br/><br/>可选值：<br/>- 'central': 主机模式;<br/>- 'peripheral': 从机（外围设备）模式;<br/> |
105
+ @@| 合法值 | 兼容性 |
106
+ @@| :- | :-: |
107
+ @@| "central" | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） |
108
+ @@| "peripheral" | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） |
109
+
110
+ #### OpenBluetoothAdapterSuccess 的属性值 @openbluetoothadaptersuccess-values
111
+
112
+ | 名称 | 类型 | 必备 | 兼容性 | 描述 |
113
+ | :- | :- | :- | :-: | :- |
114
+ | errMsg | string | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 调用结果信息。 |
115
+ | errCode | number | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | 错误码<br/><br/>\| 错误码 \| 错误信息 \| 说明 \|<br/>\| - \| - \| - \|<br/>\| 0 \| ok \| 正常 \|<br/>\| -1 \| already connect \| 已连接 \|<br/>\| 10000 \| not init \| 未初始化蓝牙适配器 \|<br/>\| 10001 \| not available \| 当前蓝牙适配器不可用 \|<br/>\| 10002 \| no device \| 没有找到指定设备 \|<br/>\| 10003 \| connection fail \| 连接失败 \|<br/>\| 10004 \| no service \| 没有找到指定服务 \|<br/>\| 10005 \| no characteristic \| 没有找到指定特征 \|<br/>\| 10006 \| no connection \| 当前连接已断开 \|<br/>\| 10007 \| property not support \| 当前特征不支持此操作 \|<br/>\| 10008 \| system error \| 其余所有系统上报的异常 \|<br/>\| 10009 \| system not support \| Android 系统特有，系统版本低于 4.3 不支持 BLE \|<br/>\| 10012 \| operate time out \| 连接超时 \|<br/>\| 10013 \| invalid_data \| 连接 deviceId 为空或者是格式不正确 \|<br/> |
116
+
117
+ #### BluetoothFail 的属性值 @bluetoothfail-values
118
+
119
+ | 名称 | 类型 | 必备 | 兼容性 | 描述 |
120
+ | :- | :- | :- | :-: | :- |
121
+ | errCode | number | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | uni 蓝牙适配器和 BLE 中心设备 API 可能返回的统一错误码。 |
122
+ | 合法值 | 兼容性 | 描述 |
123
+ | :- | :-: | :- |
124
+ | 1500101 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 蓝牙适配器尚未初始化或运行时未就绪。 |
125
+ | 1500102 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前蓝牙适配器不可用（如重置中/状态未知）。 |
126
+ | 1500103 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未找到对应的 Service。 |
127
+ | 1500104 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 调用系统蓝牙能力失败，具体原因见 cause。 |
128
+ | 1500105 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前平台或系统不支持该 BLE 能力或操作。 |
129
+ | 1509000 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未知或无法归类的 BLE 错误，具体原因见 cause。 |
130
+ | 1509001 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 连接 BLE 设备失败。 |
131
+ | 1509002 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未找到对应的 Characteristic。 |
132
+ | 1509003 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未连接上该 BLE 设备。 |
133
+ | 1509004 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前特征不支持此操作（属性不匹配）。 |
134
+ | 1509005 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | BLE 操作超时。 |
135
+ | 1509006 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未找到该设备，可能尚未扫描到或已移除。 |
136
+ | 1509007 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前 BLE 设备已经连接。 |
137
+ | 1509008 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | Android 扫描需位置权限（未授予）。 |
138
+ | 1509010 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | iOS 等待蓝牙状态更新超时。 |
139
+ | 1509601 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | BLE API 参数无效。 |
140
+ | 1509602 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未获得系统蓝牙权限。 |
141
+ | 1509603 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 系统蓝牙已关闭。 |
142
+ | 1509604 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前 BLE 设备仅可被扫描，不接受中心设备连接。 |
143
+ | 1510102 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 连接/设备数已达上限。 |
144
+ | mtu | number | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | 最终协商的 MTU 值。如果协商失败则无此参数。安卓客户端 8.0.9 开始支持。<br/> |
145
+ | errSubject | string | 是 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | 统一错误主题（模块）名称 |
146
+ | data | any | 否 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | 错误信息中包含的数据 |
147
+ | cause | Error | 否 | | 源错误信息，可以包含多个错误，详见SourceError |
148
+ | errMsg | string | 是 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | |
149
+
150
+ ### 参见
151
+ - [相关 Bug](https://issues.dcloud.net.cn/?mid=api.device.ble.openBluetoothAdapter)
152
+ - [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth/wx.openBluetoothAdapter.html)
153
+ - [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=openBluetoothAdapter&pageIndex=1&pageSize=10&source=doc_top&type=all)
154
+ - [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=openBluetoothAdapter&scope=devdocs&source=docs)
155
+ - [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=openBluetoothAdapter&secondType=all&type=1)
156
+ - [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=openBluetoothAdapter&topicFilter=)
157
+ - [钉钉小程序文档](https://open.dingtalk.com/search?keyword=openBluetoothAdapter)
158
+ - [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
159
+ - [快手小程序文档](https://developers.kuaishou.com/page?keyword=openBluetoothAdapter&from=docs)
160
+ - [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
161
+ - [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
162
+ - [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
163
+
164
+ ### 使用说明
165
+
166
+ - 初始化成功只表示应用可以使用蓝牙适配器，不代表已扫描到设备或建立连接。应在成功回调后开始扫描，再按[中心设备使用流程](./bluetooth-le-central.md#使用流程)连接和通信。
167
+ - 初始化失败时，应根据失败回调处理原因，待相关条件恢复后重新初始化，不要继续扫描或连接。
168
+
169
+ ::: sourceCode
170
+ ## uni.closeBluetoothAdapter(options) @closebluetoothadapter
171
+
172
+ 关闭蓝牙模块并释放相关系统资源，建议与 uni.openBluetoothAdapter 成对调用。
173
+
174
+ ### closeBluetoothAdapter 兼容性
175
+ | Web | 微信小程序 | 支付宝小程序 | Android | iOS(VDOM) | iOS(Vapor) | HarmonyOS |
176
+ | :- | :- | :- | :- | :- | :- | :- |
177
+ | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.41 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 5.34 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> |
178
+
179
+ ### 参数
180
+
181
+ | 名称 | 类型 | 必填 | 兼容性 | 描述 |
182
+ | :- | :- | :- | :-: | :- |
183
+ | options | **CloseBluetoothAdapterOptions** | 是 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | * |
184
+ | 名称 | 类型 | 必备 | 兼容性 | 描述 |
185
+ | :- | :- | :- | :-: | :- |
186
+ | success | (result: [CloseBluetoothAdapterSuccess](#closebluetoothadaptersuccess-values)) => void | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 接口调用成功的回调函数。 |
187
+ | fail | (result: [BluetoothFail](#bluetoothfail-values)) => void | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 接口调用失败的回调函数。 |
188
+ | complete | (result: [CloseBluetoothAdapterSuccess](#closebluetoothadaptersuccess-values) \| [BluetoothFail](#bluetoothfail-values)) => void | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 接口调用结束的回调函数，调用成功、失败都会执行。 |
189
+
190
+ #### CloseBluetoothAdapterSuccess 的属性值 @closebluetoothadaptersuccess-values
191
+
192
+ | 名称 | 类型 | 必备 | 兼容性 | 描述 |
193
+ | :- | :- | :- | :-: | :- |
194
+ | errMsg | string | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 调用结果信息。 |
195
+ | errCode | number | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | 错误码<br/><br/>\| 错误码 \| 错误信息 \| 说明 \|<br/>\| - \| - \| - \|<br/>\| 0 \| ok \| 正常 \|<br/>\| -1 \| already connect \| 已连接 \|<br/>\| 10000 \| not init \| 未初始化蓝牙适配器 \|<br/>\| 10001 \| not available \| 当前蓝牙适配器不可用 \|<br/>\| 10002 \| no device \| 没有找到指定设备 \|<br/>\| 10003 \| connection fail \| 连接失败 \|<br/>\| 10004 \| no service \| 没有找到指定服务 \|<br/>\| 10005 \| no characteristic \| 没有找到指定特征 \|<br/>\| 10006 \| no connection \| 当前连接已断开 \|<br/>\| 10007 \| property not support \| 当前特征不支持此操作 \|<br/>\| 10008 \| system error \| 其余所有系统上报的异常 \|<br/>\| 10009 \| system not support \| Android 系统特有，系统版本低于 4.3 不支持 BLE \|<br/>\| 10012 \| operate time out \| 连接超时 \|<br/>\| 10013 \| invalid_data \| 连接 deviceId 为空或者是格式不正确 \|<br/> |
196
+
197
+ #### BluetoothFail 的属性值 @bluetoothfail-values
198
+
199
+ | 名称 | 类型 | 必备 | 兼容性 | 描述 |
200
+ | :- | :- | :- | :-: | :- |
201
+ | errCode | number | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | uni 蓝牙适配器和 BLE 中心设备 API 可能返回的统一错误码。 |
202
+ | 合法值 | 兼容性 | 描述 |
203
+ | :- | :-: | :- |
204
+ | 1500101 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 蓝牙适配器尚未初始化或运行时未就绪。 |
205
+ | 1500102 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前蓝牙适配器不可用（如重置中/状态未知）。 |
206
+ | 1500103 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未找到对应的 Service。 |
207
+ | 1500104 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 调用系统蓝牙能力失败，具体原因见 cause。 |
208
+ | 1500105 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前平台或系统不支持该 BLE 能力或操作。 |
209
+ | 1509000 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未知或无法归类的 BLE 错误，具体原因见 cause。 |
210
+ | 1509001 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 连接 BLE 设备失败。 |
211
+ | 1509002 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未找到对应的 Characteristic。 |
212
+ | 1509003 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未连接上该 BLE 设备。 |
213
+ | 1509004 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前特征不支持此操作（属性不匹配）。 |
214
+ | 1509005 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | BLE 操作超时。 |
215
+ | 1509006 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未找到该设备，可能尚未扫描到或已移除。 |
216
+ | 1509007 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前 BLE 设备已经连接。 |
217
+ | 1509008 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | Android 扫描需位置权限（未授予）。 |
218
+ | 1509010 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | iOS 等待蓝牙状态更新超时。 |
219
+ | 1509601 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | BLE API 参数无效。 |
220
+ | 1509602 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未获得系统蓝牙权限。 |
221
+ | 1509603 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 系统蓝牙已关闭。 |
222
+ | 1509604 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前 BLE 设备仅可被扫描，不接受中心设备连接。 |
223
+ | 1510102 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 连接/设备数已达上限。 |
224
+ | mtu | number | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | 最终协商的 MTU 值。如果协商失败则无此参数。安卓客户端 8.0.9 开始支持。<br/> |
225
+ | errSubject | string | 是 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | 统一错误主题（模块）名称 |
226
+ | data | any | 否 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | 错误信息中包含的数据 |
227
+ | cause | Error | 否 | | 源错误信息，可以包含多个错误，详见SourceError |
228
+ | errMsg | string | 是 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | |
229
+
230
+ ### 参见
231
+ - [相关 Bug](https://issues.dcloud.net.cn/?mid=api.device.ble.closeBluetoothAdapter)
232
+ - [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth/wx.closeBluetoothAdapter.html)
233
+ - [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=closeBluetoothAdapter&pageIndex=1&pageSize=10&source=doc_top&type=all)
234
+ - [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=closeBluetoothAdapter&scope=devdocs&source=docs)
235
+ - [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=closeBluetoothAdapter&secondType=all&type=1)
236
+ - [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=closeBluetoothAdapter&topicFilter=)
237
+ - [钉钉小程序文档](https://open.dingtalk.com/search?keyword=closeBluetoothAdapter)
238
+ - [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
239
+ - [快手小程序文档](https://developers.kuaishou.com/page?keyword=closeBluetoothAdapter&from=docs)
240
+ - [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
241
+ - [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
242
+ - [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
243
+
244
+ ::: sourceCode
245
+ ## uni.getBluetoothAdapterState(options) @getbluetoothadapterstate
246
+
247
+ 获取本机蓝牙适配器状态。
248
+
249
+ ### getBluetoothAdapterState 兼容性
250
+ | Web | 微信小程序 | 支付宝小程序 | Android | iOS(VDOM) | iOS(Vapor) | HarmonyOS |
251
+ | :- | :- | :- | :- | :- | :- | :- |
252
+ | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.41 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 5.34 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> |
253
+
254
+ ### 参数
255
+
256
+ | 名称 | 类型 | 必填 | 兼容性 | 描述 |
257
+ | :- | :- | :- | :-: | :- |
258
+ | options | **GetBluetoothAdapterStateOptions** | 是 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | * |
259
+ | 名称 | 类型 | 必备 | 兼容性 | 描述 |
260
+ | :- | :- | :- | :-: | :- |
261
+ | success | (result: [GetBluetoothAdapterStateSuccess](#getbluetoothadapterstatesuccess-values)) => void | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 接口调用成功的回调函数。 |
262
+ | fail | (result: [BluetoothFail](#bluetoothfail-values)) => void | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 接口调用失败的回调函数。 |
263
+ | complete | (result: [GetBluetoothAdapterStateSuccess](#getbluetoothadapterstatesuccess-values) \| [BluetoothFail](#bluetoothfail-values)) => void | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 接口调用结束的回调函数，调用成功、失败都会执行。 |
264
+
265
+ #### GetBluetoothAdapterStateSuccess 的属性值 @getbluetoothadapterstatesuccess-values
266
+
267
+ | 名称 | 类型 | 必备 | 兼容性 | 描述 |
268
+ | :- | :- | :- | :-: | :- |
269
+ | errMsg | string | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 调用结果信息。 |
270
+ | discovering | boolean | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 是否正在搜索设备。 |
271
+ | available | boolean | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 蓝牙适配器是否可用。 |
272
+
273
+ #### BluetoothFail 的属性值 @bluetoothfail-values
274
+
275
+ | 名称 | 类型 | 必备 | 兼容性 | 描述 |
276
+ | :- | :- | :- | :-: | :- |
277
+ | errCode | number | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | uni 蓝牙适配器和 BLE 中心设备 API 可能返回的统一错误码。 |
278
+ | 合法值 | 兼容性 | 描述 |
279
+ | :- | :-: | :- |
280
+ | 1500101 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 蓝牙适配器尚未初始化或运行时未就绪。 |
281
+ | 1500102 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前蓝牙适配器不可用（如重置中/状态未知）。 |
282
+ | 1500103 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未找到对应的 Service。 |
283
+ | 1500104 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 调用系统蓝牙能力失败，具体原因见 cause。 |
284
+ | 1500105 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前平台或系统不支持该 BLE 能力或操作。 |
285
+ | 1509000 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未知或无法归类的 BLE 错误，具体原因见 cause。 |
286
+ | 1509001 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 连接 BLE 设备失败。 |
287
+ | 1509002 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未找到对应的 Characteristic。 |
288
+ | 1509003 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未连接上该 BLE 设备。 |
289
+ | 1509004 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前特征不支持此操作（属性不匹配）。 |
290
+ | 1509005 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | BLE 操作超时。 |
291
+ | 1509006 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未找到该设备，可能尚未扫描到或已移除。 |
292
+ | 1509007 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前 BLE 设备已经连接。 |
293
+ | 1509008 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | Android 扫描需位置权限（未授予）。 |
294
+ | 1509010 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | iOS 等待蓝牙状态更新超时。 |
295
+ | 1509601 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | BLE API 参数无效。 |
296
+ | 1509602 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未获得系统蓝牙权限。 |
297
+ | 1509603 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 系统蓝牙已关闭。 |
298
+ | 1509604 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前 BLE 设备仅可被扫描，不接受中心设备连接。 |
299
+ | 1510102 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 连接/设备数已达上限。 |
300
+ | mtu | number | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | 最终协商的 MTU 值。如果协商失败则无此参数。安卓客户端 8.0.9 开始支持。<br/> |
301
+ | errSubject | string | 是 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | 统一错误主题（模块）名称 |
302
+ | data | any | 否 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | 错误信息中包含的数据 |
303
+ | cause | Error | 否 | | 源错误信息，可以包含多个错误，详见SourceError |
304
+ | errMsg | string | 是 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | |
305
+
306
+ ### 参见
307
+ - [相关 Bug](https://issues.dcloud.net.cn/?mid=api.device.ble.getBluetoothAdapterState)
308
+ - [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth/wx.getBluetoothAdapterState.html)
309
+ - [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=getBluetoothAdapterState&pageIndex=1&pageSize=10&source=doc_top&type=all)
310
+ - [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=getBluetoothAdapterState&scope=devdocs&source=docs)
311
+ - [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=getBluetoothAdapterState&secondType=all&type=1)
312
+ - [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=getBluetoothAdapterState&topicFilter=)
313
+ - [钉钉小程序文档](https://open.dingtalk.com/search?keyword=getBluetoothAdapterState)
314
+ - [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
315
+ - [快手小程序文档](https://developers.kuaishou.com/page?keyword=getBluetoothAdapterState&from=docs)
316
+ - [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
317
+ - [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
318
+ - [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
319
+
320
+ ::: sourceCode
321
+ ## uni.onBluetoothAdapterStateChange(callback) @onbluetoothadapterstatechange
322
+
323
+ 监听蓝牙适配器状态变化事件。
324
+
325
+ ### onBluetoothAdapterStateChange 兼容性
326
+ | Web | 微信小程序 | 支付宝小程序 | Android | iOS(VDOM) | iOS(Vapor) | HarmonyOS |
327
+ | :- | :- | :- | :- | :- | :- | :- |
328
+ | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.41 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 5.34 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> |
329
+
330
+ ### 参数
331
+
332
+ | 名称 | 类型 | 必填 | 兼容性 | 描述 |
333
+ | :- | :- | :- | :-: | :- |
334
+ | callback | (result: [BluetoothAdapterStateChangeResult](#bluetoothadapterstatechangeresult-values)) => void | 是 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | * |
335
+
336
+ ### BluetoothAdapterStateChangeResult 的属性值 @bluetoothadapterstatechangeresult-values
337
+
338
+ | 名称 | 类型 | 必备 | 兼容性 | 描述 |
339
+ | :- | :- | :- | :-: | :- |
340
+ | available | boolean | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 蓝牙适配器是否可用。 |
341
+ | discovering | boolean | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 蓝牙适配器是否正在搜索设备。 |
342
+
343
+ ### 返回值
344
+
345
+ | 类型 |
346
+ | :- |
347
+ | number |
348
+
349
+ ### 参见
350
+ - [相关 Bug](https://issues.dcloud.net.cn/?mid=api.device.ble.onBluetoothAdapterStateChange)
351
+ - [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth/wx.onBluetoothAdapterStateChange.html)
352
+ - [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=onBluetoothAdapterStateChange&pageIndex=1&pageSize=10&source=doc_top&type=all)
353
+ - [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=onBluetoothAdapterStateChange&scope=devdocs&source=docs)
354
+ - [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=onBluetoothAdapterStateChange&secondType=all&type=1)
355
+ - [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=onBluetoothAdapterStateChange&topicFilter=)
356
+ - [钉钉小程序文档](https://open.dingtalk.com/search?keyword=onBluetoothAdapterStateChange)
357
+ - [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
358
+ - [快手小程序文档](https://developers.kuaishou.com/page?keyword=onBluetoothAdapterStateChange&from=docs)
359
+ - [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
360
+ - [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
361
+ - [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
362
+
363
+ ::: sourceCode
364
+ ## uni.offBluetoothAdapterStateChange(listener?) @offbluetoothadapterstatechange
365
+
366
+ 移除蓝牙适配器状态变化监听函数。传入监听 ID 时移除对应监听，否则移除全部监听。
367
+
368
+ ### offBluetoothAdapterStateChange 兼容性
369
+ | Web | 微信小程序 | 支付宝小程序 | Android | iOS(VDOM) | iOS(Vapor) | HarmonyOS |
370
+ | :- | :- | :- | :- | :- | :- | :- |
371
+ | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.41 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 5.34 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> |
372
+
373
+ ### 参数
374
+
375
+ | 名称 | 类型 | 必填 | 兼容性 | 描述 |
376
+ | :- | :- | :- | :-: | :- |
377
+ | listener | number \| (result: **BluetoothAdapterStateChangeResult**) => void | 否 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | * |
378
+ | 名称 | 类型 | 必备 | 兼容性 | 描述 |
379
+ | :- | :- | :- | :-: | :- |
380
+ | available | boolean | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 蓝牙适配器是否可用。 |
381
+ | discovering | boolean | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 蓝牙适配器是否正在搜索设备。 |
382
+
383
+ ### 参见
384
+ - [相关 Bug](https://issues.dcloud.net.cn/?mid=api.device.ble.offBluetoothAdapterStateChange)
385
+ - [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth/wx.offBluetoothAdapterStateChange.html)
386
+ - [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=offBluetoothAdapterStateChange&pageIndex=1&pageSize=10&source=doc_top&type=all)
387
+ - [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=offBluetoothAdapterStateChange&scope=devdocs&source=docs)
388
+ - [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=offBluetoothAdapterStateChange&secondType=all&type=1)
389
+ - [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=offBluetoothAdapterStateChange&topicFilter=)
390
+ - [钉钉小程序文档](https://open.dingtalk.com/search?keyword=offBluetoothAdapterStateChange)
391
+ - [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
392
+ - [快手小程序文档](https://developers.kuaishou.com/page?keyword=offBluetoothAdapterStateChange&from=docs)
393
+ - [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
394
+ - [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
395
+ - [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
396
+
397
+ ::: sourceCode
398
+ ## uni.startBluetoothDevicesDiscovery(options) @startbluetoothdevicesdiscovery
399
+
400
+ 开始搜寻附近的蓝牙外围设备。此操作比较耗费系统资源，搜索到需要的设备后应及时调用 uni.stopBluetoothDevicesDiscovery 停止搜索。
401
+
402
+ ### startBluetoothDevicesDiscovery 兼容性
403
+ | Web | 微信小程序 | 支付宝小程序 | Android | iOS(VDOM) | iOS(Vapor) | HarmonyOS |
404
+ | :- | :- | :- | :- | :- | :- | :- |
405
+ | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.41 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 5.34 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> |
406
+
407
+ ### 参数
408
+
409
+ | 名称 | 类型 | 必填 | 兼容性 | 描述 |
410
+ | :- | :- | :- | :-: | :- |
411
+ | options | **StartBluetoothDevicesDiscoveryOptions** | 是 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | * |
412
+ | 名称 | 类型 | 必备 | 兼容性 | 描述 |
413
+ | :- | :- | :- | :-: | :- |
414
+ | services | Array&lt;string&gt; | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 要搜索的蓝牙设备主服务 UUID 列表，支持 16、32、128 位 UUID。设置后只搜索广播包中包含对应主服务 UUID 的设备。 |
415
+ | allowDuplicatesKey | boolean | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 是否允许重复上报同一设备，默认值为 false。开启后同一设备可能被多次上报，但 RSSI 可能不同。 |
416
+ | interval | number | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 上报设备的间隔，单位 ms，默认值为 0。0 表示发现新设备后立即上报。 |
417
+ | powerLevel | string | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 扫描模式，默认值为 medium；扫描速度越高越耗电。 |
418
+ @@| 合法值 | 兼容性 | 描述 |
419
+ @@| :- | :-: | :- |
420
+ @@| "low" | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 低功耗扫描模式。 |
421
+ @@| "medium" | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 均衡扫描模式。 |
422
+ @@| "high" | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 高功耗扫描模式。 |
423
+ | success | (result: [StartBluetoothDevicesDiscoverySuccess](#startbluetoothdevicesdiscoverysuccess-values)) => void | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 接口调用成功的回调函数。 |
424
+ | fail | (result: [BluetoothFail](#bluetoothfail-values)) => void | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 接口调用失败的回调函数。 |
425
+ | complete | (result: [StartBluetoothDevicesDiscoverySuccess](#startbluetoothdevicesdiscoverysuccess-values) \| [BluetoothFail](#bluetoothfail-values)) => void | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 接口调用结束的回调函数，调用成功、失败都会执行。 |
426
+
427
+ #### StartBluetoothDevicesDiscoverySuccess 的属性值 @startbluetoothdevicesdiscoverysuccess-values
428
+
429
+ | 名称 | 类型 | 必备 | 兼容性 | 描述 |
430
+ | :- | :- | :- | :-: | :- |
431
+ | errMsg | string | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 调用结果信息。 |
432
+ | errCode | number | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | 错误码<br/><br/>\| 错误码 \| 错误信息 \| 说明 \|<br/>\| - \| - \| - \|<br/>\| 0 \| ok \| 正常 \|<br/>\| -1 \| already connect \| 已连接 \|<br/>\| 10000 \| not init \| 未初始化蓝牙适配器 \|<br/>\| 10001 \| not available \| 当前蓝牙适配器不可用 \|<br/>\| 10002 \| no device \| 没有找到指定设备 \|<br/>\| 10003 \| connection fail \| 连接失败 \|<br/>\| 10004 \| no service \| 没有找到指定服务 \|<br/>\| 10005 \| no characteristic \| 没有找到指定特征 \|<br/>\| 10006 \| no connection \| 当前连接已断开 \|<br/>\| 10007 \| property not support \| 当前特征不支持此操作 \|<br/>\| 10008 \| system error \| 其余所有系统上报的异常 \|<br/>\| 10009 \| system not support \| Android 系统特有，系统版本低于 4.3 不支持 BLE \|<br/>\| 10012 \| operate time out \| 连接超时 \|<br/>\| 10013 \| invalid_data \| 连接 deviceId 为空或者是格式不正确 \|<br/> |
433
+
434
+ #### BluetoothFail 的属性值 @bluetoothfail-values
435
+
436
+ | 名称 | 类型 | 必备 | 兼容性 | 描述 |
437
+ | :- | :- | :- | :-: | :- |
438
+ | errCode | number | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | uni 蓝牙适配器和 BLE 中心设备 API 可能返回的统一错误码。 |
439
+ | 合法值 | 兼容性 | 描述 |
440
+ | :- | :-: | :- |
441
+ | 1500101 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 蓝牙适配器尚未初始化或运行时未就绪。 |
442
+ | 1500102 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前蓝牙适配器不可用（如重置中/状态未知）。 |
443
+ | 1500103 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未找到对应的 Service。 |
444
+ | 1500104 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 调用系统蓝牙能力失败，具体原因见 cause。 |
445
+ | 1500105 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前平台或系统不支持该 BLE 能力或操作。 |
446
+ | 1509000 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未知或无法归类的 BLE 错误，具体原因见 cause。 |
447
+ | 1509001 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 连接 BLE 设备失败。 |
448
+ | 1509002 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未找到对应的 Characteristic。 |
449
+ | 1509003 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未连接上该 BLE 设备。 |
450
+ | 1509004 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前特征不支持此操作（属性不匹配）。 |
451
+ | 1509005 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | BLE 操作超时。 |
452
+ | 1509006 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未找到该设备，可能尚未扫描到或已移除。 |
453
+ | 1509007 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前 BLE 设备已经连接。 |
454
+ | 1509008 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | Android 扫描需位置权限（未授予）。 |
455
+ | 1509010 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | iOS 等待蓝牙状态更新超时。 |
456
+ | 1509601 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | BLE API 参数无效。 |
457
+ | 1509602 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未获得系统蓝牙权限。 |
458
+ | 1509603 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 系统蓝牙已关闭。 |
459
+ | 1509604 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前 BLE 设备仅可被扫描，不接受中心设备连接。 |
460
+ | 1510102 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 连接/设备数已达上限。 |
461
+ | mtu | number | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | 最终协商的 MTU 值。如果协商失败则无此参数。安卓客户端 8.0.9 开始支持。<br/> |
462
+ | errSubject | string | 是 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | 统一错误主题（模块）名称 |
463
+ | data | any | 否 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | 错误信息中包含的数据 |
464
+ | cause | Error | 否 | | 源错误信息，可以包含多个错误，详见SourceError |
465
+ | errMsg | string | 是 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | |
466
+
467
+ ### 参见
468
+ - [相关 Bug](https://issues.dcloud.net.cn/?mid=api.device.ble.startBluetoothDevicesDiscovery)
469
+ - [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth/wx.startBluetoothDevicesDiscovery.html)
470
+ - [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=startBluetoothDevicesDiscovery&pageIndex=1&pageSize=10&source=doc_top&type=all)
471
+ - [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=startBluetoothDevicesDiscovery&scope=devdocs&source=docs)
472
+ - [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=startBluetoothDevicesDiscovery&secondType=all&type=1)
473
+ - [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=startBluetoothDevicesDiscovery&topicFilter=)
474
+ - [钉钉小程序文档](https://open.dingtalk.com/search?keyword=startBluetoothDevicesDiscovery)
475
+ - [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
476
+ - [快手小程序文档](https://developers.kuaishou.com/page?keyword=startBluetoothDevicesDiscovery&from=docs)
477
+ - [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
478
+ - [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
479
+ - [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
480
+
481
+ ::: sourceCode
482
+ ## uni.stopBluetoothDevicesDiscovery(options) @stopbluetoothdevicesdiscovery
483
+
484
+ 停止搜寻附近的蓝牙外围设备。
485
+
486
+ ### stopBluetoothDevicesDiscovery 兼容性
487
+ | Web | 微信小程序 | 支付宝小程序 | Android | iOS(VDOM) | iOS(Vapor) | HarmonyOS |
488
+ | :- | :- | :- | :- | :- | :- | :- |
489
+ | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.41 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 5.34 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> |
490
+
491
+ ### 参数
492
+
493
+ | 名称 | 类型 | 必填 | 兼容性 | 描述 |
494
+ | :- | :- | :- | :-: | :- |
495
+ | options | **StopBluetoothDevicesDiscoveryOptions** | 是 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | * |
496
+ | 名称 | 类型 | 必备 | 兼容性 | 描述 |
497
+ | :- | :- | :- | :-: | :- |
498
+ | success | (result: [StopBluetoothDevicesDiscoverySuccess](#stopbluetoothdevicesdiscoverysuccess-values)) => void | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 接口调用成功的回调函数。 |
499
+ | fail | (result: [BluetoothFail](#bluetoothfail-values)) => void | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 接口调用失败的回调函数。 |
500
+ | complete | (result: [StopBluetoothDevicesDiscoverySuccess](#stopbluetoothdevicesdiscoverysuccess-values) \| [BluetoothFail](#bluetoothfail-values)) => void | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 接口调用结束的回调函数，调用成功、失败都会执行。 |
501
+
502
+ #### StopBluetoothDevicesDiscoverySuccess 的属性值 @stopbluetoothdevicesdiscoverysuccess-values
503
+
504
+ | 名称 | 类型 | 必备 | 兼容性 | 描述 |
505
+ | :- | :- | :- | :-: | :- |
506
+ | errMsg | string | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 调用结果信息。 |
507
+ | errCode | number | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | 错误码<br/><br/>\| 错误码 \| 错误信息 \| 说明 \|<br/>\| - \| - \| - \|<br/>\| 0 \| ok \| 正常 \|<br/>\| -1 \| already connect \| 已连接 \|<br/>\| 10000 \| not init \| 未初始化蓝牙适配器 \|<br/>\| 10001 \| not available \| 当前蓝牙适配器不可用 \|<br/>\| 10002 \| no device \| 没有找到指定设备 \|<br/>\| 10003 \| connection fail \| 连接失败 \|<br/>\| 10004 \| no service \| 没有找到指定服务 \|<br/>\| 10005 \| no characteristic \| 没有找到指定特征 \|<br/>\| 10006 \| no connection \| 当前连接已断开 \|<br/>\| 10007 \| property not support \| 当前特征不支持此操作 \|<br/>\| 10008 \| system error \| 其余所有系统上报的异常 \|<br/>\| 10009 \| system not support \| Android 系统特有，系统版本低于 4.3 不支持 BLE \|<br/>\| 10012 \| operate time out \| 连接超时 \|<br/>\| 10013 \| invalid_data \| 连接 deviceId 为空或者是格式不正确 \|<br/> |
508
+
509
+ #### BluetoothFail 的属性值 @bluetoothfail-values
510
+
511
+ | 名称 | 类型 | 必备 | 兼容性 | 描述 |
512
+ | :- | :- | :- | :-: | :- |
513
+ | errCode | number | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | uni 蓝牙适配器和 BLE 中心设备 API 可能返回的统一错误码。 |
514
+ | 合法值 | 兼容性 | 描述 |
515
+ | :- | :-: | :- |
516
+ | 1500101 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 蓝牙适配器尚未初始化或运行时未就绪。 |
517
+ | 1500102 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前蓝牙适配器不可用（如重置中/状态未知）。 |
518
+ | 1500103 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未找到对应的 Service。 |
519
+ | 1500104 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 调用系统蓝牙能力失败，具体原因见 cause。 |
520
+ | 1500105 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前平台或系统不支持该 BLE 能力或操作。 |
521
+ | 1509000 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未知或无法归类的 BLE 错误，具体原因见 cause。 |
522
+ | 1509001 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 连接 BLE 设备失败。 |
523
+ | 1509002 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未找到对应的 Characteristic。 |
524
+ | 1509003 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未连接上该 BLE 设备。 |
525
+ | 1509004 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前特征不支持此操作（属性不匹配）。 |
526
+ | 1509005 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | BLE 操作超时。 |
527
+ | 1509006 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未找到该设备，可能尚未扫描到或已移除。 |
528
+ | 1509007 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前 BLE 设备已经连接。 |
529
+ | 1509008 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | Android 扫描需位置权限（未授予）。 |
530
+ | 1509010 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | iOS 等待蓝牙状态更新超时。 |
531
+ | 1509601 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | BLE API 参数无效。 |
532
+ | 1509602 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未获得系统蓝牙权限。 |
533
+ | 1509603 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 系统蓝牙已关闭。 |
534
+ | 1509604 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前 BLE 设备仅可被扫描，不接受中心设备连接。 |
535
+ | 1510102 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 连接/设备数已达上限。 |
536
+ | mtu | number | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | 最终协商的 MTU 值。如果协商失败则无此参数。安卓客户端 8.0.9 开始支持。<br/> |
537
+ | errSubject | string | 是 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | 统一错误主题（模块）名称 |
538
+ | data | any | 否 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | 错误信息中包含的数据 |
539
+ | cause | Error | 否 | | 源错误信息，可以包含多个错误，详见SourceError |
540
+ | errMsg | string | 是 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | |
541
+
542
+ ### 参见
543
+ - [相关 Bug](https://issues.dcloud.net.cn/?mid=api.device.ble.stopBluetoothDevicesDiscovery)
544
+ - [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth/wx.stopBluetoothDevicesDiscovery.html)
545
+ - [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=stopBluetoothDevicesDiscovery&pageIndex=1&pageSize=10&source=doc_top&type=all)
546
+ - [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=stopBluetoothDevicesDiscovery&scope=devdocs&source=docs)
547
+ - [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=stopBluetoothDevicesDiscovery&secondType=all&type=1)
548
+ - [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=stopBluetoothDevicesDiscovery&topicFilter=)
549
+ - [钉钉小程序文档](https://open.dingtalk.com/search?keyword=stopBluetoothDevicesDiscovery)
550
+ - [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
551
+ - [快手小程序文档](https://developers.kuaishou.com/page?keyword=stopBluetoothDevicesDiscovery&from=docs)
552
+ - [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
553
+ - [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
554
+ - [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
555
+
556
+ ::: sourceCode
557
+ ## uni.onBluetoothDeviceFound(listener) @onbluetoothdevicefound
558
+
559
+ 监听搜索到新设备的事件。回调上报的设备会加入 uni.getBluetoothDevices 返回的设备列表。
560
+
561
+ ### onBluetoothDeviceFound 兼容性
562
+ | Web | 微信小程序 | 支付宝小程序 | Android | iOS(VDOM) | iOS(Vapor) | HarmonyOS |
563
+ | :- | :- | :- | :- | :- | :- | :- |
564
+ | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.41 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 5.34 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> |
565
+
566
+ ### 参数
567
+
568
+ | 名称 | 类型 | 必填 | 兼容性 | 描述 |
569
+ | :- | :- | :- | :-: | :- |
570
+ | listener | (result: [BluetoothDeviceFoundResult](#bluetoothdevicefoundresult-values)) => void | 是 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | * |
571
+
572
+ ### BluetoothDeviceFoundResult 的属性值 @bluetoothdevicefoundresult-values
573
+
574
+ | 名称 | 类型 | 必备 | 兼容性 | 描述 |
575
+ | :- | :- | :- | :-: | :- |
576
+ | devices | Array&lt;**BluetoothDevice**&gt; | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 新搜索到的设备列表。 |
577
+ | 名称 | 类型 | 必备 | 兼容性 | 描述 |
578
+ | :- | :- | :- | :-: | :- |
579
+ | name | string | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 蓝牙设备名称。某些设备可能没有名称；连接后名称可能由广播包中的 LocalName 变为设备的 GattName。 |
580
+ | deviceId | string | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 用于区分蓝牙设备的 ID。 |
581
+ | RSSI | number | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前蓝牙设备的信号强度，单位 dBm。 |
582
+ | advertisData | ArrayBuffer | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前蓝牙设备广播数据中的 ManufacturerData 数据段。 |
583
+ | advertisServiceUUIDs | Array&lt;string&gt; | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前蓝牙设备广播数据中的 ServiceUUIDs 数据段。 |
584
+ | localName | string | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前蓝牙设备广播数据中的 LocalName 数据段。 |
585
+ | serviceData | UTSJSONObject | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前蓝牙设备广播数据中的 ServiceData 数据段，键为服务 UUID，值为对应的二进制数据。 |
586
+ | connectable | boolean | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前蓝牙设备是否可连接。Android 8.0 以下不返回该值。 |
587
+
588
+ ### 返回值
589
+
590
+ | 类型 |
591
+ | :- |
592
+ | number |
593
+
594
+ ### 参见
595
+ - [相关 Bug](https://issues.dcloud.net.cn/?mid=api.device.ble.onBluetoothDeviceFound)
596
+ - [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth/wx.onBluetoothDeviceFound.html)
597
+ - [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=onBluetoothDeviceFound&pageIndex=1&pageSize=10&source=doc_top&type=all)
598
+ - [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=onBluetoothDeviceFound&scope=devdocs&source=docs)
599
+ - [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=onBluetoothDeviceFound&secondType=all&type=1)
600
+ - [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=onBluetoothDeviceFound&topicFilter=)
601
+ - [钉钉小程序文档](https://open.dingtalk.com/search?keyword=onBluetoothDeviceFound)
602
+ - [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
603
+ - [快手小程序文档](https://developers.kuaishou.com/page?keyword=onBluetoothDeviceFound&from=docs)
604
+ - [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
605
+ - [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
606
+ - [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
607
+
608
+ ::: sourceCode
609
+ ## uni.offBluetoothDeviceFound(listener?) @offbluetoothdevicefound
610
+
611
+ 移除搜索到新设备的事件监听。传入监听 ID 时移除对应监听，否则移除全部监听。
612
+
613
+ ### offBluetoothDeviceFound 兼容性
614
+ | Web | 微信小程序 | 支付宝小程序 | Android | iOS(VDOM) | iOS(Vapor) | HarmonyOS |
615
+ | :- | :- | :- | :- | :- | :- | :- |
616
+ | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.41 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 5.34 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> |
617
+
618
+ ### 参数
619
+
620
+ | 名称 | 类型 | 必填 | 兼容性 | 描述 |
621
+ | :- | :- | :- | :-: | :- |
622
+ | listener | number \| (result: **BluetoothDeviceFoundResult**) => void | 否 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | * |
623
+ | 名称 | 类型 | 必备 | 兼容性 | 描述 |
624
+ | :- | :- | :- | :-: | :- |
625
+ | devices | Array&lt;**BluetoothDevice**&gt; | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 新搜索到的设备列表。 |
626
+ @@| 名称 | 类型 | 必备 | 兼容性 | 描述 |
627
+ @@| :- | :- | :- | :-: | :- |
628
+ @@| name | string | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 蓝牙设备名称。某些设备可能没有名称；连接后名称可能由广播包中的 LocalName 变为设备的 GattName。 |
629
+ @@| deviceId | string | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 用于区分蓝牙设备的 ID。 |
630
+ @@| RSSI | number | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前蓝牙设备的信号强度，单位 dBm。 |
631
+ @@| advertisData | ArrayBuffer | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前蓝牙设备广播数据中的 ManufacturerData 数据段。 |
632
+ @@| advertisServiceUUIDs | Array&lt;string&gt; | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前蓝牙设备广播数据中的 ServiceUUIDs 数据段。 |
633
+ @@| localName | string | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前蓝牙设备广播数据中的 LocalName 数据段。 |
634
+ @@| serviceData | UTSJSONObject | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前蓝牙设备广播数据中的 ServiceData 数据段，键为服务 UUID，值为对应的二进制数据。 |
635
+ @@| connectable | boolean | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前蓝牙设备是否可连接。Android 8.0 以下不返回该值。 |
636
+
637
+ ### 参见
638
+ - [相关 Bug](https://issues.dcloud.net.cn/?mid=api.device.ble.offBluetoothDeviceFound)
639
+ - [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth/wx.offBluetoothDeviceFound.html)
640
+ - [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=offBluetoothDeviceFound&pageIndex=1&pageSize=10&source=doc_top&type=all)
641
+ - [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=offBluetoothDeviceFound&scope=devdocs&source=docs)
642
+ - [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=offBluetoothDeviceFound&secondType=all&type=1)
643
+ - [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=offBluetoothDeviceFound&topicFilter=)
644
+ - [钉钉小程序文档](https://open.dingtalk.com/search?keyword=offBluetoothDeviceFound)
645
+ - [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
646
+ - [快手小程序文档](https://developers.kuaishou.com/page?keyword=offBluetoothDeviceFound&from=docs)
647
+ - [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
648
+ - [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
649
+ - [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
650
+
651
+ ::: sourceCode
652
+ ## uni.getBluetoothDevices(options) @getbluetoothdevices
653
+
654
+ 获取蓝牙模块生效期间所有搜索到的蓝牙设备，包括已经和本机处于连接状态的设备。
655
+
656
+ ### getBluetoothDevices 兼容性
657
+ | Web | 微信小程序 | 支付宝小程序 | Android | iOS(VDOM) | iOS(Vapor) | HarmonyOS |
658
+ | :- | :- | :- | :- | :- | :- | :- |
659
+ | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.41 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 5.34 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> |
660
+
661
+ ### 参数
662
+
663
+ | 名称 | 类型 | 必填 | 兼容性 | 描述 |
664
+ | :- | :- | :- | :-: | :- |
665
+ | options | **GetBluetoothDevicesOptions** | 是 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | * |
666
+ | 名称 | 类型 | 必备 | 兼容性 | 描述 |
667
+ | :- | :- | :- | :-: | :- |
668
+ | success | (result: [GetBluetoothDevicesSuccess](#getbluetoothdevicessuccess-values)) => void | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 接口调用成功的回调函数。 |
669
+ | fail | (result: [BluetoothFail](#bluetoothfail-values)) => void | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 接口调用失败的回调函数。 |
670
+ | complete | (result: [GetBluetoothDevicesSuccess](#getbluetoothdevicessuccess-values) \| [BluetoothFail](#bluetoothfail-values)) => void | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 接口调用结束的回调函数，调用成功、失败都会执行。 |
671
+
672
+ #### GetBluetoothDevicesSuccess 的属性值 @getbluetoothdevicessuccess-values
673
+
674
+ | 名称 | 类型 | 必备 | 兼容性 | 描述 |
675
+ | :- | :- | :- | :-: | :- |
676
+ | errMsg | string | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 调用结果信息。 |
677
+ | devices | Array&lt;**BluetoothDevice**&gt; | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 蓝牙模块生效期间搜索到的设备列表，包括已经和本机处于连接状态的设备。 |
678
+ | 名称 | 类型 | 必备 | 兼容性 | 描述 |
679
+ | :- | :- | :- | :-: | :- |
680
+ | name | string | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 蓝牙设备名称。某些设备可能没有名称；连接后名称可能由广播包中的 LocalName 变为设备的 GattName。 |
681
+ | deviceId | string | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 用于区分蓝牙设备的 ID。 |
682
+ | RSSI | number | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前蓝牙设备的信号强度，单位 dBm。 |
683
+ | advertisData | ArrayBuffer | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前蓝牙设备广播数据中的 ManufacturerData 数据段。 |
684
+ | advertisServiceUUIDs | Array&lt;string&gt; | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前蓝牙设备广播数据中的 ServiceUUIDs 数据段。 |
685
+ | localName | string | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前蓝牙设备广播数据中的 LocalName 数据段。 |
686
+ | serviceData | UTSJSONObject | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前蓝牙设备广播数据中的 ServiceData 数据段，键为服务 UUID，值为对应的二进制数据。 |
687
+ | connectable | boolean | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前蓝牙设备是否可连接。Android 8.0 以下不返回该值。 |
688
+
689
+ #### BluetoothFail 的属性值 @bluetoothfail-values
690
+
691
+ | 名称 | 类型 | 必备 | 兼容性 | 描述 |
692
+ | :- | :- | :- | :-: | :- |
693
+ | errCode | number | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | uni 蓝牙适配器和 BLE 中心设备 API 可能返回的统一错误码。 |
694
+ | 合法值 | 兼容性 | 描述 |
695
+ | :- | :-: | :- |
696
+ | 1500101 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 蓝牙适配器尚未初始化或运行时未就绪。 |
697
+ | 1500102 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前蓝牙适配器不可用（如重置中/状态未知）。 |
698
+ | 1500103 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未找到对应的 Service。 |
699
+ | 1500104 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 调用系统蓝牙能力失败，具体原因见 cause。 |
700
+ | 1500105 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前平台或系统不支持该 BLE 能力或操作。 |
701
+ | 1509000 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未知或无法归类的 BLE 错误，具体原因见 cause。 |
702
+ | 1509001 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 连接 BLE 设备失败。 |
703
+ | 1509002 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未找到对应的 Characteristic。 |
704
+ | 1509003 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未连接上该 BLE 设备。 |
705
+ | 1509004 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前特征不支持此操作（属性不匹配）。 |
706
+ | 1509005 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | BLE 操作超时。 |
707
+ | 1509006 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未找到该设备，可能尚未扫描到或已移除。 |
708
+ | 1509007 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前 BLE 设备已经连接。 |
709
+ | 1509008 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | Android 扫描需位置权限（未授予）。 |
710
+ | 1509010 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | iOS 等待蓝牙状态更新超时。 |
711
+ | 1509601 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | BLE API 参数无效。 |
712
+ | 1509602 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未获得系统蓝牙权限。 |
713
+ | 1509603 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 系统蓝牙已关闭。 |
714
+ | 1509604 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前 BLE 设备仅可被扫描，不接受中心设备连接。 |
715
+ | 1510102 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 连接/设备数已达上限。 |
716
+ | mtu | number | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | 最终协商的 MTU 值。如果协商失败则无此参数。安卓客户端 8.0.9 开始支持。<br/> |
717
+ | errSubject | string | 是 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | 统一错误主题（模块）名称 |
718
+ | data | any | 否 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | 错误信息中包含的数据 |
719
+ | cause | Error | 否 | | 源错误信息，可以包含多个错误，详见SourceError |
720
+ | errMsg | string | 是 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | |
721
+
722
+ ### 参见
723
+ - [相关 Bug](https://issues.dcloud.net.cn/?mid=api.device.ble.getBluetoothDevices)
724
+ - [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth/wx.getBluetoothDevices.html)
725
+ - [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=getBluetoothDevices&pageIndex=1&pageSize=10&source=doc_top&type=all)
726
+ - [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=getBluetoothDevices&scope=devdocs&source=docs)
727
+ - [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=getBluetoothDevices&secondType=all&type=1)
728
+ - [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=getBluetoothDevices&topicFilter=)
729
+ - [钉钉小程序文档](https://open.dingtalk.com/search?keyword=getBluetoothDevices)
730
+ - [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
731
+ - [快手小程序文档](https://developers.kuaishou.com/page?keyword=getBluetoothDevices&from=docs)
732
+ - [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
733
+ - [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
734
+ - [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
735
+
736
+ ::: sourceCode
737
+ ## uni.getConnectedBluetoothDevices(options) @getconnectedbluetoothdevices
738
+
739
+ 根据主服务 UUID 获取已连接的蓝牙设备。
740
+
741
+ ### getConnectedBluetoothDevices 兼容性
742
+ | Web | 微信小程序 | 支付宝小程序 | Android | iOS(VDOM) | iOS(Vapor) | HarmonyOS |
743
+ | :- | :- | :- | :- | :- | :- | :- |
744
+ | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.41 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 5.34 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> |
745
+
746
+ ### 参数
747
+
748
+ | 名称 | 类型 | 必填 | 兼容性 | 描述 |
749
+ | :- | :- | :- | :-: | :- |
750
+ | options | **GetConnectedBluetoothDevicesOptions** | 是 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | * |
751
+ | 名称 | 类型 | 必备 | 兼容性 | 描述 |
752
+ | :- | :- | :- | :-: | :- |
753
+ | services | Array&lt;string&gt; | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 蓝牙设备主服务 UUID 列表，支持 16、32、128 位 UUID。 |
754
+ | success | (result: [GetConnectedBluetoothDevicesSuccess](#getconnectedbluetoothdevicessuccess-values)) => void | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 接口调用成功的回调函数。 |
755
+ | fail | (result: [BluetoothFail](#bluetoothfail-values)) => void | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 接口调用失败的回调函数。 |
756
+ | complete | (result: [GetConnectedBluetoothDevicesSuccess](#getconnectedbluetoothdevicessuccess-values) \| [BluetoothFail](#bluetoothfail-values)) => void | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 接口调用结束的回调函数，调用成功、失败都会执行。 |
757
+
758
+ #### GetConnectedBluetoothDevicesSuccess 的属性值 @getconnectedbluetoothdevicessuccess-values
759
+
760
+ | 名称 | 类型 | 必备 | 兼容性 | 描述 |
761
+ | :- | :- | :- | :-: | :- |
762
+ | errMsg | string | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 调用结果信息。 |
763
+ | devices | Array&lt;**ConnectedBluetoothDevice**&gt; | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 指定主服务 UUID 对应的已连接设备列表。 |
764
+ | 名称 | 类型 | 必备 | 兼容性 | 描述 |
765
+ | :- | :- | :- | :-: | :- |
766
+ | name | string | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 蓝牙设备名称。某些设备可能没有名称。 |
767
+ | deviceId | string | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 用于区分蓝牙设备的 ID。 |
768
+
769
+ #### BluetoothFail 的属性值 @bluetoothfail-values
770
+
771
+ | 名称 | 类型 | 必备 | 兼容性 | 描述 |
772
+ | :- | :- | :- | :-: | :- |
773
+ | errCode | number | 是 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | uni 蓝牙适配器和 BLE 中心设备 API 可能返回的统一错误码。 |
774
+ | 合法值 | 兼容性 | 描述 |
775
+ | :- | :-: | :- |
776
+ | 1500101 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 蓝牙适配器尚未初始化或运行时未就绪。 |
777
+ | 1500102 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前蓝牙适配器不可用（如重置中/状态未知）。 |
778
+ | 1500103 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未找到对应的 Service。 |
779
+ | 1500104 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 调用系统蓝牙能力失败，具体原因见 cause。 |
780
+ | 1500105 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前平台或系统不支持该 BLE 能力或操作。 |
781
+ | 1509000 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未知或无法归类的 BLE 错误，具体原因见 cause。 |
782
+ | 1509001 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 连接 BLE 设备失败。 |
783
+ | 1509002 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未找到对应的 Characteristic。 |
784
+ | 1509003 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未连接上该 BLE 设备。 |
785
+ | 1509004 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前特征不支持此操作（属性不匹配）。 |
786
+ | 1509005 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | BLE 操作超时。 |
787
+ | 1509006 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未找到该设备，可能尚未扫描到或已移除。 |
788
+ | 1509007 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前 BLE 设备已经连接。 |
789
+ | 1509008 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | Android 扫描需位置权限（未授予）。 |
790
+ | 1509010 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | iOS 等待蓝牙状态更新超时。 |
791
+ | 1509601 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | BLE API 参数无效。 |
792
+ | 1509602 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 未获得系统蓝牙权限。 |
793
+ | 1509603 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 系统蓝牙已关闭。 |
794
+ | 1509604 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 当前 BLE 设备仅可被扫描，不接受中心设备连接。 |
795
+ | 1510102 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS(VDOM) x / iOS(Vapor) 5.34 / HarmonyOS x（部分支持，见上） | 连接/设备数已达上限。 |
796
+ | mtu | number | 否 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | 最终协商的 MTU 值。如果协商失败则无此参数。安卓客户端 8.0.9 开始支持。<br/> |
797
+ | errSubject | string | 是 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | 统一错误主题（模块）名称 |
798
+ | data | any | 否 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | 错误信息中包含的数据 |
799
+ | cause | Error | 否 | | 源错误信息，可以包含多个错误，详见SourceError |
800
+ | errMsg | string | 是 | Web x / 支付宝小程序 x / Android x / HarmonyOS x（部分支持，见上） | |
801
+
802
+ ### 参见
803
+ - [相关 Bug](https://issues.dcloud.net.cn/?mid=api.device.ble.getConnectedBluetoothDevices)
804
+ - [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth/wx.getConnectedBluetoothDevices.html)
805
+ - [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=getConnectedBluetoothDevices&pageIndex=1&pageSize=10&source=doc_top&type=all)
806
+ - [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=getConnectedBluetoothDevices&scope=devdocs&source=docs)
807
+ - [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=getConnectedBluetoothDevices&secondType=all&type=1)
808
+ - [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=getConnectedBluetoothDevices&topicFilter=)
809
+ - [钉钉小程序文档](https://open.dingtalk.com/search?keyword=getConnectedBluetoothDevices)
810
+ - [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
811
+ - [快手小程序文档](https://developers.kuaishou.com/page?keyword=getConnectedBluetoothDevices&from=docs)
812
+ - [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
813
+ - [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
814
+ - [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
815
+
816
+ ## 通用类型
817
+
818
+ ### GeneralCallbackResult @generalcallbackresult-values
819
+
820
+ | 名称 | 类型 | 必备 | 描述 |
821
+ | :- | :- | :- | :- |
822
+ | errMsg | string | 是 | 错误信息 |