QBluetoothPermission Class
Bluetooth周辺機器にアクセスします。詳細...
| ヘッダー: | #include <QPermissions> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| 以下のように: | 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) |
詳細な説明
要件
実行時にこの権限を要求するには、ビルド時に以下のプラットフォーム固有の使用宣言を行う必要があります:
| プラットフォーム | 型 | |
|---|---|---|
| Apple | 使用法の説明 | NSBluetoothAlwaysUsageDescription |
| Android | uses-permission | Android 11 まで（API レベル < 31）：
Android 12以降（APIレベル 31以上）：
|
プロジェクトへの追加方法については、個々の使用宣言タイプをご参照ください。
注： Qt 6.8.1以降 、API レベルが 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
この列挙型は、許可されるBluetooth通信モードを制御するために使用されます。
| 定数 | 値 | 説明 |
|---|---|---|
QBluetoothPermission::Access | 0x01 | このデバイスが他の Bluetooth デバイスにアクセスできるようにします。これには、近くのデバイスのスキャンや、それらへの接続が含まれます。 |
QBluetoothPermission::Advertise | 0x02 | 他の Bluetooth デバイスがこのデバイスを検出できるようにします。 |
QBluetoothPermission::Default | Access | 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()も参照してください 。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
