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
  • android.permission.ACCESS_FINE_LOCATION

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

注: 現在 Android では、android.permission.ACCESS_FINE_LOCATION パーミッションは Bluetooth パーミッションと一緒に要求されます。アプリケーションがアプリケーションマニフェストで Bluetooth を使用して物理的な位置を導出しないことを強く表明しない限り、これは Bluetooth が正しく動作するために必要です。このパーミッションのカップリングは将来変更される可能性があります。

QPermissionQCoreApplication::requestPermission()、QCoreApplication::checkPermission()、およびApplication Permissionsも参照してください

メンバ型ドキュメント

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

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

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

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

注意: 今のところ、AndroidのAccess モードはprecise location パーミッションも要求します。このパーミッションのカップリングは将来変更される可能性があります。

この列挙型は 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.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。