Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

コア超広帯域無線（UWB）

API リファレンス
androidx.core.uwb

サポート対象のデバイスに超広帯域無線（UWB）を実装します。

最新の更新	安定版リリース	リリース候補版	ベータ版リリース	アルファ版リリース
2026 年 5 月 19 日	1.0.0	-	-	1.1.0-alpha01

依存関係の宣言

core への依存関係を追加するには、Google Maven リポジトリをプロジェクトに追加する必要があります。詳しくは、Google の Maven リポジトリをご覧ください。

アプリまたはモジュールの build.gradle ファイルに、必要なアーティファクトの依存関係を追加します。

Groovy

dependencies {
    // Use to implement UWB (ultra-wideband) on supported devices
    implementation "androidx.core.uwb:uwb:1.1.0-alpha01"
}

Kotlin

dependencies {
    // Use to implement UWB (ultra-wideband) on supported devices
    implementation("androidx.core.uwb:uwb:1.1.0-alpha01")
}

依存関係について詳しくは、ビルド依存関係の追加をご覧ください。

フィードバック

お寄せいただいたフィードバックは Jetpack 改善の参考にさせていただきます。新しい問題が見つかった場合や、このライブラリを改善するアイデアをお持ちの場合は、お知らせください。新しい問題を報告していただく前に、このライブラリの既存の問題をご確認ください。スターボタンをクリックすると、既存の問題に投票できます。

新しい問題を報告する

詳細については、Issue Tracker のドキュメントをご覧ください。

バージョン 1.1

バージョン 1.1.0-alpha01

2026 年 5 月 19 日

androidx.core.uwb:uwb:1.1.0-alpha01 と androidx.core.uwb:uwb-rxjava3:1.1.0-alpha01 がリリースされました。バージョン 1.1.0-alpha01 に含まれる commit については、こちらをご覧ください。

API の変更

UwbManager の新しい API close() を追加して、UWB サービスをバインド解除します。(I4606f、b/498499531)

バージョン 1.0

バージョン 1.0.0

2026 年 5 月 6 日

androidx.core.uwb:uwb:1.0.0 と androidx.core.uwb:uwb-rxjava3:1.0.0 がリリースされました。バージョン 1.0.0 に含まれる commit については、こちらをご覧ください。

バージョン 1.0.0-rc01

2026 年 4 月 8 日

androidx.core.uwb:uwb:1.0.0-rc01 と androidx.core.uwb:uwb-rxjava3:1.0.0-rc01 がリリースされました。バージョン 1.0.0-rc01 に含まれる commit については、こちらをご覧ください。

バージョン 1.0.0-beta01

2026 年 3 月 11 日

androidx.core.uwb:uwb:1.0.0-beta01 と androidx.core.uwb:uwb-rxjava3:1.0.0-beta01 がリリースされました。バージョン 1.0.0-beta01 に含まれる commit については、こちらをご覧ください。

バージョン 1.0.0-alpha11

2025 年 12 月 3 日

androidx.core.uwb:uwb:1.0.0-alpha11 と androidx.core.uwb:uwb-rxjava3:1.0.0-alpha11 がリリースされました。バージョン 1.0.0-alpha11 に含まれる commit については、こちらをご覧ください。

API の変更

レンジングセッションの失敗と理由を報告する新しい API RangingResultFailure を導入しました。レンジングの開始に失敗した場合、既存の RangingResultPeerDisconnected コールバックに理由が含まれます（If3715）。

バージョン 1.0.0-alpha10

2024 年 12 月 11 日

androidx.core.uwb:uwb:1.0.0-alpha10 と androidx.core.uwb:uwb-rxjava3:1.0.0-alpha10 がリリースされました。バージョン 1.0.0-alpha10 に含まれる commit については、こちらをご覧ください。

API の変更

UWB の状態変更の理由コード STATE_CHANGE_REASON_UNKNOWN、STATE_CHANGE_REASON_SYSTEM_POLICY、STATE_CHANGE_REASON_COUNTRY_CODE_ERROR を追加しました。(I43e36)
レンジングセッションが初期化されたときにイベントを送信する新しい API RangingResult#RangingResultInitialized を追加しました。（I386bb）
UWB の状態変更イベントをリッスンする新しい API subscribeToUwbAvailability(observer: UwbAvailabilityCallback) と unsubscribeFromUwbAvailability() を追加しました。UWB の状態変更イベントが検出されたときにコールバック関数を定義する新しいインターフェース UwbAvailabilityCallback を追加しました。（I37191）

バージョン 1.0.0-alpha09

2024 年 10 月 16 日

androidx.core.uwb:uwb:1.0.0-alpha09 と androidx.core.uwb:uwb-rxjava3:1.0.0-alpha09 がリリースされました。バージョン 1.0.0-alpha09 に含まれる commit については、こちらをご覧ください。

API の変更

UWB の可用性を確認する新しい API isAvailable() を追加しました。(If6fc6)
controlee p-sts 個別キーケースの追加をサポートする新しい API addControleeWithSessionParams を追加しました。(Ie7849)

バージョン 1.0.0-alpha08

2024 年 1 月 24 日

androidx.core.uwb:uwb:1.0.0-alpha08 と androidx.core.uwb:uwb-rxjava3:1.0.0-alpha08 がリリースされました。バージョン 1.0.0-alpha08 に含まれる commit については、こちらをご覧ください。

API の変更

サードパーティ製アプリがレンジング間隔、スロット時間の設定、AoA の有効化/無効化を行えるように、新しい機能とパラメータを追加しました。レンジング間隔と範囲データ通知の再構成をサポートする新しい API を追加しました。(Iebd18)

バージョン 1.0.0-alpha07

2023 年 8 月 23 日

androidx.core.uwb:uwb:1.0.0-alpha07 と androidx.core.uwb:uwb-rxjava3:1.0.0-alpha07 がリリースされました。バージョン 1.0.0-alpha07 に含まれる commit については、こちらをご覧ください。

バグの修正

中国のデバイスに Google Play 開発者サービスがインストールされている場合に AOSP バックエンドが使用されない問題を修正しました。

バージョン 1.0.0-alpha06

2023 年 7 月 26 日

androidx.core.uwb:uwb:1.0.0-alpha06 と androidx.core.uwb:uwb-rxjava3:1.0.0-alpha06 がリリースされました。バージョン 1.0.0-alpha06 に含まれる commit については、こちらをご覧ください。

新機能

プロビジョニングされた STS のサポートを追加しました。デバイスがプロビジョニングされた STS に対応している場合、UWB レンジングにプロビジョニングされた STS を選択できるようになりました。(I19812)

API の変更

rangingParameters に subSessionId と subSessionKeyInfo を追加しました。プロビジョニングされた STS をサポートする新しい構成 ID を追加しました。(I19812)
a、b、c パスの公開 API ファイルと試験運用版 API ファイルを統合しました（I8cfee、b/278769092）。
該当なし。API ファイルの変更はメソッドの並べ替えのみです（I5fa95）。
統合された公開 API ファイルを使用するように androidx.core グループを移行しました（Ifdef4、b/278769092）。
rangingCapabilities に minRangingInterval、supportedChannels、supportedConfigIds を新しいフィールドとして追加しました。（I2a204）

バグの修正

gms 以外の領域で UWB クライアントを作成できない問題を修正しました。

バージョン 1.0.0-alpha05

2023 年 4 月 5 日

androidx.core.uwb:uwb:1.0.0-alpha05 と androidx.core.uwb:uwb-rxjava3:1.0.0-alpha05 がリリースされました。バージョン 1.0.0-alpha05 に含まれる commit については、こちらをご覧ください。

API の変更

RangingParameters#CONFIG_ID_1 を CONFIG_UNICAST_DS_TWR に名前変更しました。
新しい構成 ID RangingParameters#CONFIG_MULTICAST_DS_TWR を追加しました。(I2f1b7)

バグの修正

複数のレンジングセッションを並行して開始できないバグを修正しました。

バージョン 1.0.0-alpha04

2022 年 12 月 7 日

androidx.core.uwb:uwb:1.0.0-alpha04 と androidx.core.uwb:uwb-rxjava3:1.0.0-alpha04 がリリースされました。バージョン 1.0.0-alpha04 に含まれる commit については、こちらをご覧ください。

新機能

GMS のサポートがない場合、AndroidX API は、AOSP プラットフォームを介して OEM に配布される AOSP UWB バックエンドサービスを使用しようとします。（532de0）

API の変更

@JvmDefaultWithCompatibility アノテーションを追加しました。（I8f206）

バージョン 1.0.0-alpha03

2022 年 8 月 10 日

androidx.core.uwb:uwb:1.0.0-alpha03 と androidx.core.uwb:uwb-rxjava3:1.0.0-alpha03 がリリースされました。バージョン 1.0.0-alpha03 に含まれるコミットについては、こちらをご覧ください。

新機能

新しいレンジングプロファイル、Controller が導入されました。Controller プロファイルを持つ UWB デバイスは、2 つのデバイスが使用するレンジングチャネルを決定できます。

API の変更

UWB のコントローラサポートを追加（I52a71）

バージョン 1.0.0-alpha02

2022 年 6 月 29 日

androidx.core.uwb:uwb-rxjava3:1.0.0-alpha02 がリリースされました。バージョン 1.0.0-alpha02 に含まれる commit については、こちらをご覧ください。

新機能

uwb モジュール用の Java の相互運用可能なアーティファクトを導入しました。新しいアーティファクトは rxjava3 に依存しており、Java クライアントに対して消費可能です。

バージョン 1.0.0-alpha02

2022 年 6 月 15 日

androidx.core.uwb:uwb:1.0.0-alpha02 がリリースされました。バージョン 1.0.0-alpha02 に含まれる commit については、こちらをご覧ください。

新機能

公開版の UWB_CONFIG_ID_1 の導入

API の変更

RangingResultPosition の距離が null 許容になりました

バージョン 1.0.0-alpha01

2022 年 6 月 1 日

androidx.core.uwb:uwb:1.0.0-alpha01 がリリースされました。バージョン 1.0.0-alpha01 に含まれる commit については、こちらをご覧ください。

新機能

UWB ライブラリには、デベロッパーが UWB 対応デバイスを操作するための一連の API が用意されています。ユースケースは、UWB 圏内のセッションの Controller プロファイルをすでに前提とし、近い将来に Controller プロファイルのサポートが予定されている、パートナー提携デバイスに限定されます。この初回リリースには、2 つのトップレベル API サーフェス（UwbManager、UwbClientSessionScope）が含まれています。