Context.GetSystemService メソッド

定義

オーバーロード

GetSystemService(Class)

クラス別にシステム レベルのサービスにハンドルを返します。

GetSystemService(String)

名前でシステム レベルのサービスにハンドルを返します。

GetSystemService(Class)

クラス別にシステム レベルのサービスにハンドルを返します。

[Android.Runtime.Register("getSystemService", "(Ljava/lang/Class;)Ljava/lang/Object;", "", ApiSince=23)]
[Java.Interop.JavaTypeParameters(new System.String[] { "T" })]
public Java.Lang.Object? GetSystemService (Java.Lang.Class serviceClass);
[<Android.Runtime.Register("getSystemService", "(Ljava/lang/Class;)Ljava/lang/Object;", "", ApiSince=23)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "T" })>]
member this.GetSystemService : Java.Lang.Class -> Java.Lang.Object

パラメーター

serviceClass
Class

目的のサービスのクラス。

戻り値

サービス、または null クラスがサポートされているシステム サービスでない場合は 。 注: <名前がサポートされていない場合、b>never</b> は を RuntimeException スローしません。

属性

注釈

クラス別にシステム レベルのサービスにハンドルを返します。

現在使用できるクラスはandroid.view.WindowManager、、android.view.LayoutInflaterandroid.app.ActivityManager、、android.os.PowerManagerandroid.app.AlarmManagerandroid.app.NotificationManager、、、android.app.KeyguardManagerandroid.location.LocationManager、、android.app.SearchManagerandroid.os.Vibratorandroid.telephony.SubscriptionManagerandroid.app.usage.NetworkStatsManagerandroid.app.DownloadManagerandroid.os.BatteryManagerandroid.app.UiModeManagerandroid.app.job.JobSchedulerandroid.content.pm.verify.domain.DomainVerificationManagerandroid.net.ConnectivityManagerandroid.media.AudioManagerandroid.view.displayhash.DisplayHashManagerandroid.net.wifi.WifiManagerandroid.media.MediaRouterandroid.telephony.TelephonyManagerandroid.view.inputmethod.InputMethodManagerです。

注: この API を介して取得されたシステム サービスは、取得元のコンテキストと密接に関連付けられている可能性があります。 一般に、さまざまなコンテキスト (アクティビティ、アプリケーション、サービス、プロバイダーなど) 間でサービス オブジェクトを共有しないでください。

注: true を返すPackageManager#isInstantApp()インスタント アプリには、、、 の各システム サービス#FINGERPRINT_SERVICE#WIFI_SERVICE#DEVICE_POLICY_SERVICE#SHORTCUT_SERVICE#WIFI_AWARE_SERVICE#KEYGUARD_SERVICE#USB_SERVICE#WALLPAPER_SERVICE#WIFI_P2P_SERVICEにアクセスできません。 これらのサービスの場合、このメソッドは を返します null。 一般に、インスタント アプリとして実行している場合は、このメソッドnullの結果が であるかどうかを常にチェックする必要があります。

の Java ドキュメント android.content.Context.getSystemService(java.lang.Class<T>)

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象

GetSystemService(String)

名前でシステム レベルのサービスにハンドルを返します。

[Android.Runtime.Register("getSystemService", "(Ljava/lang/String;)Ljava/lang/Object;", "GetGetSystemService_Ljava_lang_String_Handler")]
public abstract Java.Lang.Object? GetSystemService (string name);
[<Android.Runtime.Register("getSystemService", "(Ljava/lang/String;)Ljava/lang/Object;", "GetGetSystemService_Ljava_lang_String_Handler")>]
abstract member GetSystemService : string -> Java.Lang.Object

パラメーター

name
String

目的のサービスの名前。

戻り値

サービスまたは null 名前が存在しない場合は 。

属性

注釈

名前でシステム レベルのサービスにハンドルを返します。 返されるオブジェクトのクラスは、要求された名前によって異なります。 現在使用できる名前は次のとおりです。

<dl><dt>#WINDOW_SERVICE ("window") <dd> カスタム ウィンドウを配置できる最上位のウィンドウ マネージャー。 返されるオブジェクトは です android.view.WindowManager。 アクティビティや で作成された #createWindowContext(int, Bundle)コンテキストなどの視覚的コンテキストからのみ取得する必要があります。このコンテキストは、画面上の領域の構成と視覚的境界に合わせて調整されます。 <このコンテキストでレイアウト リソースを拡張するための dt>#LAYOUT_INFLATER_SERVICE ("layout_inflater") <dd> A android.view.LayoutInflater 。 アクティビティや で作成された #createWindowContext(int, Bundle)コンテキストなどの視覚的コンテキストからのみ取得する必要があります。このコンテキストは、画面上の領域の構成と視覚的境界に合わせて調整されます。 <システムのグローバル アクティビティ状態を操作するための dt>#ACTIVITY_SERVICE ("activity") <dd> A android.app.ActivityManager 。 <>#WALLPAPER_SERVICE dt ("wallpaper") <このコンテキストで壁紙にアクセスするための dd> Aandroid.service.wallpaper.WallpaperService。 アクティビティや で作成された #createWindowContext(int, Bundle)コンテキストなどの視覚的コンテキストからのみ取得する必要があります。このコンテキストは、画面上の領域の構成と視覚的境界に合わせて調整されます。 <電源管理を制御するための dt>#POWER_SERVICE ("power") <dd> A android.os.PowerManager 。 <選択時に意図を受信するための dt>#ALARM_SERVICE ("alarm") <dd> A android.app.AlarmManager 。 <バックグラウンド イベントをユーザーに通知するための dt>#NOTIFICATION_SERVICE ("notification") <dd> A android.app.NotificationManager 。 <キーガードを制御するための dt>#KEYGUARD_SERVICE ("keyguard") <dd> A android.app.KeyguardManager 。 <場所 (GPS など) の更新を制御するための dt>#LOCATION_SERVICE ("location") <dd> A android.location.LocationManager 。 <検索を処理するための dt>#SEARCH_SERVICE ("search") <dd> A android.app.SearchManager 。 <デバイスの振動子にアクセスし、個々の振動子と対話し、複数の振動子に対して同期効果を再生するための dt>#VIBRATOR_MANAGER_SERVICE ("vibrator_manager") <dd> A android.os.VibratorManager 。 <振動子ハードウェアと対話するための dt>#VIBRATOR_SERVICE ("バイブレータ") <dd> A android.os.Vibrator 。 <ネットワーク接続の管理を処理するための dt>#CONNECTIVITY_SERVICE ("connectivity") <dd> A android.net.ConnectivityManager ConnectivityManager 。 <ソケットとネットワークで IPSec を管理するための dt>#IPSEC_SERVICE ("ipsec") <dd> A android.net.IpSecManager IpSecManager 。 <Wi-Fi 接続を管理するための dt>#WIFI_SERVICE ("wifi") <dd> A android.net.wifi.WifiManager WifiManager 。 Android 7 より前のリリースでは、呼び出し元プロセス内のメモリ リークを回避するために、他の派生コンテキストからではなく、アプリケーション コンテキストからのみ取得する必要があります。 <dt>#WIFI_AWARE_SERVICE ("wifiaware") <dd> A android.net.wifi.aware.WifiAwareManager WifiAwareManager for management of Wi-Fi Aware discovery and connectivity. <dt>#WIFI_P2P_SERVICE ("wifip2p") <dd> A android.net.wifi.p2p.WifiP2pManager WifiP2pManager for management of Wi-Fi Direct connectivity. <dt>#INPUT_METHOD_SERVICE ("input_method") <dd> 入力メソッドの管理用の 。android.view.inputmethod.InputMethodManager InputMethodManager <dt>#UI_MODE_SERVICE ("uimode") <dd>android.app.UiModeManager UI モードを制御するための 。 <dt>#DOWNLOAD_SERVICE ("download") <dd> A android.app.DownloadManager for requesting HTTP downloads <dt>#BATTERY_SERVICE ("batterymanager") <dd> A android.os.BatteryManager for managing battery state <dt>#JOB_SCHEDULER_SERVICE ("taskmanager") <dd> A android.app.job.JobScheduler for manageing scheduled tasks <dt>#NETWORK_STATS_SERVICE ("netstats") <dd> A android.app.usage.NetworkStatsManager NetworkStatsManager for querying network usage statistics. <ハードウェア プロパティにアクセスするための dt>#HARDWARE_PROPERTIES_SERVICE ("hardware_properties") <dd> A android.os.HardwarePropertiesManager 。 <Web ドメイン承認状態にアクセスするための dt>#DOMAIN_VERIFICATION_SERVICE ("domain_verification") <dd> A android.content.pm.verify.domain.DomainVerificationManager 。 <表示ハッシュを管理するための dt>#DISPLAY_HASH_SERVICE ("display_hash") <dd> A android.view.displayhash.DisplayHashManager 。 </Dl>

注: この API を介して取得されたシステム サービスは、取得元のコンテキストと密接に関連付けられている可能性があります。 一般に、さまざまなコンテキスト (アクティビティ、アプリケーション、サービス、プロバイダーなど) 間でサービス オブジェクトを共有しないでください。

注: true を返すPackageManager#isInstantApp()インスタント アプリには、、、 の各システム サービス#FINGERPRINT_SERVICE#WIFI_SERVICE#DEVICE_POLICY_SERVICE#SHORTCUT_SERVICE#WIFI_AWARE_SERVICE#KEYGUARD_SERVICE#USB_SERVICE#WALLPAPER_SERVICE#WIFI_P2P_SERVICEにアクセスできません。 これらのサービスの場合、このメソッドは を返します null。 一般に、インスタント アプリとして実行している場合は、このメソッドnullの結果が であるかどうかを常にチェックする必要があります。

注: このメソッドを実装するときは、新しい Android リリースで新しいサービスを追加できることに注意してください。そのため、上記の明示的な名前だけを探している場合は、mdash &名前が認識されないときに 必ず を返 null してください。代わりに例外をスロー RuntimeException すると、アプリが新しい Android リリースで中断する可能性があります。

の Java ドキュメント android.content.Context.getSystemService(java.lang.String)

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

こちらもご覧ください

適用対象