「.NET for Androidでディスプレイをスリープさせない」の版間の差分

ビジュアルウィキテキスト

@@ 1行目: / 1行目: @@
 == 概要 ==
 無操作でもディスプレイをスリープさせたくない場面も多い。
 たとえば[[MonoGame]]で作る[[Android]]向けの[[ゲーム]]などである。
+== 環境 ==
+* Xamarin.Android
+* .NET for Android
+Xamarin.Androidの頃から変わっていない。
 == 解決策：KeepScreenOn ==
-アクティビティに「WindowManagerFlags.KeepScreenOn」というフラグを設定すると一時的にディスプレイのスリープを抑制できる。この方法は権限が不要であり、アクティビティが遷移する際に自動的に解除される。
+アクティビティに「WindowManagerFlags.KeepScreenOn」というフラグを設定すると一時的にディスプレイのスリープを抑制できます。この方法は
-<source lang=“csharp”>
+* 権限が不要であり
-         protected override void OnCreate(Bundle bundle)
+* アクティビティが遷移する際に自動的に解除されます
-        {
-            base.OnCreate(bundle);
+<source lang=csharp>
+public class MainActivity : Activity
+{
+    protected override void OnCreate(Bundle? savedInstanceState)
+    {
+        base.OnCreate(savedInstanceState);
+        // 画面をオフにしない。
+         this.Window!.AddFlags(Android.Views.WindowManagerFlags.KeepScreenOn);
+    }
+}
+</source>
+[[MonoGame]]でもこの方法は有効です。
+<source lang=csharp>
+public class Activity1 : AndroidGameActivity
+{
+    protected override void OnCreate(Bundle bundle)
+    {
+        base.OnCreate(bundle);
-            // ディスプレイをスリープさせない
+        // ディスプレイをスリープさせない
-            this.Window.AddFlags(WindowManagerFlags.KeepScreenOn);
+        this.Window.AddFlags(WindowManagerFlags.KeepScreenOn);
-        }
+    }
+}
 </source>
 == 解決策：wakelock ==
-この方法は権限が必要であり、ひとたびディスプレイのスリープを抑制するとアクティビティが遷移しようが何をしようが明示的に解除しない限り延々と抑制される。あまりオススメできない。
+WakeLockを使う方法は、権限が必要であり、ひとたびディスプレイのスリープを抑制するとアクティビティが遷移しようが何をしようが明示的に解除しない限り延々とスリープが抑制されます。
-よって省略する。
-== 関連項目 ==
+当然のように素人にはオススメできない代物です。
-* [[Xamarin.Android/画面の向きを固定する]]
+; 必要な権限
+* 	<uses-permission android:name="android.permission.WAKE_LOCK" />
+; 大雑把なソース
+どうしても使いたい場合はWakeLock利用中のあらゆる暴走をtry/catchして確実にReleaseしてください。
+[[メモリ不足]]などの「アプリ外の影響」「[[OS]]の暴走」も想定しましょう。
+<source lang=csharp>
+PowerManager? _powerManager;
+PowerManager.WakeLock? _wakelock;
+void Initialize()
+{
+    _powerManager = GetSystemService(Context.PowerService) as PowerManager;
+    _wakelock = _powerManager?.NewWakeLock(WakeLockFlags.Full, "tag")!;
+}
+void Start()
+{
+    if (_wakelock != null)
+    {
+        _wakelock.Acquire();
+    }
+}
-== 参考文献 ==
+void Stop()
-{{reflist}}
+{
+    if (_wakelock != null && _wakelock.IsHeld)
+    {
+        _wakelock.Release();
+    }
+}
-{{stub}}
+void Release()
+{
+    if (_wakelock != null)
+    {
+        if (_wakelock.IsHeld)
+        {
+            _wakelock.Release();
+        }
+        _wakelock.Dispose();
+        _wakelock = null;
+    }
+}
+</source>
+== 関連項目 ==
+* [[Xamarin.Androidで画面の向きを固定する]]
-[[category:Xamarin.Mac]]
+[[category: .NET for Android]]
-[[category:MonoGame]]
+[[category: MonoGame]]