Back to Qt.io
Contact Us Blog Download Qt

QBluetoothPermission Class

Bluetooth周辺機器にアクセスします。詳細...

Header: #include <QPermissions>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core
Since: Qt 6.5

パブリックタイプ

(since 6.6) enum CommunicationMode { Access, Advertise, Default }
flags CommunicationModes

パブリック関数

(since 6.6) QBluetoothPermission::CommunicationModes communicationModes() const
(since 6.6) void setCommunicationModes(QBluetoothPermission::CommunicationModes modes)

詳細説明

必要条件

実行時にこの権限を要求するには、ビルド時に以下のプラットフォーム固有の使用宣言を行う必要があります：

プラットフォームプラットフォーム
アップル使用法の説明NSBluetoothAlwaysUsageDescription
アンドロイドuses-permissionAndroid 11 (API Level < 31)まで：
  • android.permission.BLUETOOTH
  • android.permission.ACCESS_FINE_LOCATION

Android 12 (API Level >= 31)から：

  • android.permission.BLUETOOTH_ADVERTISE
  • android.permission.BLUETOOTH_CONNECT
  • android.permission.BLUETOOTH_SCAN

プロジェクトへの追加方法については、個々の使用宣言タイプを参照してください。

注意: Qt 6.8.1以降、API Level >= 31の場合、ACCESS_FINE_LOCATIONパーミッションは要求されなくなりました。これにより、Bluetoothのスキャン結果が制限される場合があります。これらの結果を必要とするユーザーは、ロケーションパーミッションを別途要求し（precise location を参照）、BLUETOOTH_SCAN パーミッションにandroid:usesPermissionFlags="neverForLocation" 属性が設定されていないことを確認する必要があります。アプリケーション マニフェストでのパーミッションの設定およびカスタマイズについては、このガイドを参照してください。

QPermission 、QCoreApplication::requestPermission()、QCoreApplication::checkPermission()、およびアプリケーション権限も参照してください 。

メンバ型ドキュメント

[since 6.6] enum QBluetoothPermission::CommunicationMode
flags QBluetoothPermission::CommunicationModes

この enum は、許可された Bluetooth 通信モードを制御するために使用されます。

定数値説明
QBluetoothPermission::Access0x01このデバイスが他の Bluetooth デバイスにアクセスすることを許可します。これには、近くのデバイスをスキャンして接続することが含まれます。
QBluetoothPermission::Advertise0x02他のBluetoothデバイスがこのデバイスを検出することを許可します。
QBluetoothPermission::DefaultAccess | Advertiseこの設定はデフォルトで使用されます。

注： きめ細かいパーミッションは、現在Android 12以降でのみサポートされています。古いバージョンの Android や Apple オペレーティングシステムでは、どのモードでも Bluetooth のフルアクセスになります。

この列挙型は Qt 6.6 で導入されました。

CommunicationModes 型はQFlags<CommunicationMode> の typedef です。これは、CommunicationMode 値の OR の組み合わせを格納します。

メンバー関数説明

[since 6.6] QBluetoothPermission::CommunicationModes QBluetoothPermission::communicationModes() const

許可されている Bluetooth 通信モードを返します。

この関数は Qt 6.6 で導入されました。

setCommunicationModes()も参照してください 。

[since 6.6] void QBluetoothPermission::setCommunicationModes(QBluetoothPermission::CommunicationModes modes)

許可される Bluetooth 通信モードをmodes に設定します。

注意: デフォルトで構築されたCommunicationModes のインスタンスには意味がないため、このようなモードを設定しようとするとqWarning() が発生し、Default モードの使用にフォールバックします。

この関数は Qt 6.6 で導入されました。

communicationModes()も参照してください 。

©2024 The Qt Company Ltd. 本書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。