iOSアプリで画面の明るさをプログラムから変更する方法

画面の明るさを変更する基本

iOSで画面の明るさをプログラムから変更するには、UIScreenクラスのbrightnessプロパティを使用します。このプロパティはメインスクリーン（UIScreen.main）でのみサポートされており、外部ディスプレイなどには適用できない点に注意してください。

設定できる値は0.0〜1.0の範囲（両端を含む）です。0.0が最も暗く、1.0が最も明るい状態を表します。

明るさの変更が保持される期間に注意

アプリによって変更された明るさは、デバイスがロックされるまで有効です。アプリを終了しても設定は維持されます。一方、ユーザーが「設定」アプリやコントロールセンターで指定したシステムの明るさは、次にディスプレイがオンになったときに復元されます。

つまり、このプロパティによる変更はあくまで一時的なものであり、システム設定そのものを上書きするわけではありません。夜間モードや動画再生時の一時的な輝度調整などに適した仕組みです。

実装方法（Swift）

brightnessプロパティはインスタンスプロパティです。実際にiOSアプリで動作を確認したい場合は、ViewControllerのviewDidLoadメソッドに以下の1行を追加するだけで効果を確認できます。

override func viewDidLoad() {
    super.viewDidLoad()
    UIScreen.main.brightness = 0.1 // 0.0〜1.0の範囲で指定
}

Objective-Cの場合

[UIScreen mainScreen].brightness = 0.1;

まとめ

• 明るさの変更は「UIScreen.main.brightness」を使用する
• 値の範囲は0.0〜1.0（0.0が最も暗い）
• 変更はデバイスのロックまで有効で、システム設定は復元される
• 夜間モードやコンテンツ表示時の輝度調整などに活用できる