mediaQueryのViewingDistanceでわかる距離

Jetpack Compose 1.11.x で新たに登場した mediaQuery に ViewingDistance というユーザーとデバイス画面の間の一般的な距離を取得することができるようになっています。
この "ユーザーとデバイス画面の間の一般的な距離" とは何なのか気になったのでその調べたメモです。

ViewingDistance でわかる距離

ViewingDistance 自体は近接センサーでユーザとデバイスの距離がわかるというものではなく、デバイスの種類でおおよその近さが定義されているものになります。
具体的には以下の表のように、デバイスからのおおよその距離で定数が用意されています。

Property	デバイス例
Near(近い)	スマートフォン、タブレット、ノートパソコン、デスクトップモニターなど
Medium(中距離)	自動車搭載機器やドックモードのタブレット
Far(遠い)	TV

ViewingDistance の使い道

ユーザーとデバイス画面の間の一般的な距離を元にフォントサイズの調整を行ったりするのが主なユースケースになります。

val fontSize = when {
    mediaQuery { viewingDistance == UiMediaScope.ViewingDistance.Far } -> 20.sp
    mediaQuery { viewingDistance == UiMediaScope.ViewingDistance.Medium } -> 18.sp
    else -> 16.sp
}

ViewingDistance の内部実装

下記リンク先が実装内部になります。
PackageManager から TV や Automotive かを判定したり、タブレットのドックモードかを Intent から判定して、ViewingDistance を決定しています。