Permissions Overview

To support BLE + local Wi‑Fi provisioning, QR scanning, encrypted device control, firmware updates, voice control, widgets, notifications, and optional geofencing automation, the app requires a set of network, nearby device, camera/microphone, and location permissions. Counts vary by Android version due to Nearby/Wi‑Fi and Bluetooth permission changes.

• Base (API 33+, Android 13+):
  • Total: 9 (Dangerous: 6, Normal: 3)
  • Dangerous: CAMERA, RECORD_AUDIO, POST_NOTIFICATIONS, BLUETOOTH_SCAN, BLUETOOTH_CONNECT, NEARBY_WIFI_DEVICES
  • Normal: INTERNET, ACCESS_NETWORK_STATE, ACCESS_WIFI_STATE (plus CHANGE_WIFI_STATE)
• With optional Geofencing (API 33+ enabled by user):
  • +2 Dangerous: ACCESS_FINE_LOCATION, ACCESS_BACKGROUND_LOCATION
  • +1 Normal: FOREGROUND_SERVICE (already present if you use foreground services), RECEIVE_BOOT_COMPLETED (recommended to restore geofences after reboot)
• API 31–32 (Android 12):
  • Replace NEARBY_WIFI_DEVICES with ACCESS_FINE_LOCATION for Wi‑Fi provisioning; BLE uses BLUETOOTH_SCAN/CONNECT
• API ≤30 (Android 11 and below):
  • BLE scanning/connection needs BLUETOOTH, BLUETOOTH_ADMIN (normal) plus ACCESS_FINE_LOCATION (dangerous); Wi‑Fi provisioning also requires ACCESS_FINE_LOCATION

Permission Details Table

Notes:

• BLUETOOTH_ADVERTISE (API 31+) is not required unless the app acts as a BLE peripheral. Omit unless you implement advertising.
• ACCESS_COARSE_LOCATION isn’t necessary if you already request ACCESS_FINE_LOCATION.

Configuration Suggestions (AndroidManifest.xml and runtime)

• Declare version‑specific permissions:
  • Android 13+ (targetSdk 33+):
  • Android 12 (API 31–32):
    • Use BLUETOOTH_SCAN/BLUETOOTH_CONNECT; use ACCESS_FINE_LOCATION for Wi‑Fi provisioning
    • For BLUETOOTH_SCAN, add uses-permission flags if applicable:
  • Android ≤30:
• Common declarations:
  • Optional:
    • (if geofencing/automation must persist after reboot)
    • (request only after user enables automation)
• Foreground service types (Android 12+):
  • In the service element: android:foregroundServiceType="location|dataSync"
    • Use “location” for geofencing service; “dataSync” is suitable for OTA updates if done in a foreground service.
• Hardware features (for Play device filtering):
  • (set false if app can work without camera; otherwise true)
• Runtime request best practices:
  • Gate “Arrive/Leave home” behind an explicit user toggle; request ACCESS_FINE_LOCATION first, then ACCESS_BACKGROUND_LOCATION with clear rationale.
  • Request POST_NOTIFICATIONS on first use of alerts (API 33+).
  • Request BLUETOOTH_* and NEARBY_WIFI_DEVICES only when starting provisioning/scan.
  • Use staged prompts and in‑context education screens; avoid blanket requests at app start.

Compatibility Notes

• Bluetooth permissions:
  • API ≤30: BLE scanning/connection requires BLUETOOTH/BLUETOOTH_ADMIN plus ACCESS_FINE_LOCATION (location gating for BLE).
  • API 31+ (Android 12): Use BLUETOOTH_SCAN and BLUETOOTH_CONNECT (runtime). Location permission is not required for BLE if you don’t derive location; set android:usesPermissionFlags="neverForLocation" for BLUETOOTH_SCAN when applicable.
• Wi‑Fi nearby device provisioning:
  • API 33+ (Android 13): Use NEARBY_WIFI_DEVICES for discovering/connecting to nearby device SoftAPs; do not request location solely for this purpose.
  • API ≤32: Wi‑Fi scanning/specifier/suggestion flows require ACCESS_FINE_LOCATION.
• Notifications:
  • API 33+: POST_NOTIFICATIONS is a runtime dangerous permission.
  • API ≤32: No permission needed to post notifications, but you must use notification channels on API 26+.
• Geofencing/background location:
  • Requires ACCESS_FINE_LOCATION; background geofencing needs ACCESS_BACKGROUND_LOCATION on Android 10+.
  • Request ACCESS_BACKGROUND_LOCATION only after user opts in to automation; provide an in‑app rationale and settings link if denied.
• Foreground services:
  • API 31+: Declare appropriate foregroundServiceType (e.g., location) on services; FOREGROUND_SERVICE permission remains normal.
• Widgets:
  • App widgets do not require additional permissions (BIND_APPWIDGET is system‑signature; not applicable to third‑party apps).

This list adheres to least‑privilege: only permissions necessary for the described features are included, with version‑specific and optional items clearly indicated.

権限総覧

• 想定される権限総数（条件付きを含む）：12
• 区分
  • 普通権限（4）：INTERNET, ACCESS_NETWORK_STATE, MODIFY_AUDIO_SETTINGS, FOREGROUND_SERVICE
  • 危険（ランタイム）権限
    • 必須（2）：CAMERA, RECORD_AUDIO
    • 機能オプション（1）：ACCESS_FINE_LOCATION（位置タグ機能を利用する場合のみ）
    • OS依存（1）：POST_NOTIFICATIONS（Android 13+ のみ）
  • バージョン依存/代替実装時（4）
    • WRITE_EXTERNAL_STORAGE（API 28以下でアルバム保存を行う場合）
    • READ_EXTERNAL_STORAGE（API 32以下でシステムフォトピッカー/SAFを使わずに媒体参照する場合）
    • READ_MEDIA_IMAGES / READ_MEDIA_VIDEO（API 33+でシステムフォトピッカーを使わずに画像/動画を参照する場合）

※ 本設計では Android 13+ はシステムフォトピッカー優先、低APIは分割（スコープド）ストレージ/SAFを利用する想定のため、READ_/WRITE 系権限は「条件付き」とし、極力申請を回避します。

権限詳細（表）

注記

• 位置情報は前景利用のみ。ACCESS_BACKGROUND_LOCATION は不要です。
• ストレージ系の READ_/WRITE 権限は「代替実装時のみ」。本要件（フォトピッカー/MediaStore遵守）では申請を避けられます。

設定の推奨事項（AndroidManifest.xml 等）

• 最小権限原則
  • 画像/動画のインポートは Android 13+ ではシステムフォトピッカー（ActivityResultContracts.PickVisualMedia 等）を使用し、READ_MEDIA_* を申請しない。
  • Android 11–12 でも Playサービス対応のフォトピッカー/SAF を優先。自前ギャラリー実装を行わない限り READ_EXTERNAL_STORAGE を申請しない。
• ストレージの後方互換
  • 作品のアルバム保存は MediaStore 経由で行う。MANAGE_EXTERNAL_STORAGE（広範囲ストレージ）は申請しない。
  • API 28以下をサポートする場合のみ WRITE_EXTERNAL_STORAGE を宣言し、maxSdkVersion を付与：
    • uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="28"
  • READ_EXTERNAL_STORAGE を使う場合も必要な場合に限定し、API 32までで maxSdkVersion を付与：
    • uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32"
• フォアグラウンドサービス
  • uses-permission android:name="android.permission.FOREGROUND_SERVICE"
  • Service 宣言に android:foregroundServiceType="dataSync" を設定（アップロード用途）。camera/microphone 等のタイプは不要。
  • startForeground() を即時呼び出し、進捗通知を継続表示。
• 通知（Android 13+）
  • uses-permission android:name="android.permission.POST_NOTIFICATIONS"
  • 初回起動時にまとめてではなく、アップロード/メッセージ機能開始時にコンテキストを示してランタイムリクエスト。
• 位置情報（前景のみ）
  • uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"
  • 位置タグ選択時のみランタイムリクエスト。バックグラウンド位置権限は申請しない。
• オーディオ
  • イヤモニ用に MODIFY_AUDIO_SETTINGS を宣言。Bluetooth制御用の BLUETOOTH_* 系権限は不要（システムのオーディオルーティングに委ねる）。

兼容性（バージョン差異）

• Android 14 (API 34)
  • フォアグラウンドサービスの種類が厳格化。アップロードは foregroundServiceType="dataSync" を使用し、追加の特殊FGS権限（CAMERA/MICROPHONE等）は不要。
  • フォトピッカー利用時はストレージ権限不要。
• Android 13 (API 33)
  • POST_NOTIFICATIONS がランタイム化。通知を出すにはユーザー許可が必要。
  • フォトピッカー利用なら READ_MEDIA_* は不要。自前でメディア一覧を参照する場合は READ_MEDIA_IMAGES/READ_MEDIA_VIDEO を個別申請。
• Android 12/12L (API 31–32)
  • 通知権限は不要（自動許可）。フォトピッカー（Playサービス提供）または SAF を利用すれば READ_EXTERNAL_STORAGE は不要。
  • 自前ギャラリー実装時は READ_EXTERNAL_STORAGE が必要。
• Android 10–11 (API 29–30)
  • スコープドストレージ有効。MediaStore 経由の保存は WRITE_EXTERNAL_STORAGE 不要。
  • 読み取りは SAF/フォトピッカーを使えば権限不要。自前参照なら READ_EXTERNAL_STORAGE が必要。
• Android 9以下 (API 28-)
  • MediaStore 経由でも実体は外部ストレージ書き込みのため WRITE_EXTERNAL_STORAGE が必要。
  • 既存メディア読み取りには READ_EXTERNAL_STORAGE が必要（SAF を使う場合は不要）。

以上により、当アプリのコア機能に必要な権限のみを選定し、OSバージョンと実装方針に応じてストレージ権限を最小化する構成を推奨します。