语言

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 类是否不是受支持的系统服务。 注意:如果名称不受支持, 则永远不会 引发 RuntimeException 该名称。

特性

注解

按类将句柄返回到系统级服务。

当前可用的类包括:android.view.WindowManager、、android.view.LayoutInflater、android.app.ActivityManager、android.os.PowerManagerandroid.app.AlarmManagerandroid.app.NotificationManagerandroid.app.KeyguardManagerandroid.location.LocationManagerandroid.app.SearchManagerandroid.os.Vibratorandroid.net.ConnectivityManagerandroid.net.wifi.WifiManagerandroid.media.AudioManagerandroid.media.MediaRouterandroid.telephony.TelephonyManagerandroid.telephony.SubscriptionManagerandroid.view.inputmethod.InputMethodManagerandroid.app.UiModeManagerandroid.app.DownloadManagerandroid.os.BatteryManagerandroid.app.job.JobSchedulerandroid.app.usage.NetworkStatsManagerandroid.content.pm.verify.domain.DomainVerificationManagerandroid.view.displayhash.DisplayHashManagerandroid.security.authenticationpolicy.AuthenticationPolicyManager。

注意:通过此 API 获取的系统服务可能与从中获取它们的上下文紧密关联。 通常,不要在各种不同上下文(活动、应用程序、服务、提供程序等)之间共享服务对象。

注意:返回 true 的即时应用PackageManager#isInstantApp()无权访问以下系统服务:#DEVICE_POLICY_SERVICE、、、#FINGERPRINT_SERVICE、#KEYGUARD_SERVICE#SHORTCUT_SERVICE#USB_SERVICE、#WALLPAPER_SERVICE、#WIFI_P2P_SERVICE、 、 。 #WIFI_SERVICE#WIFI_AWARE_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 ,用于与系统的全局活动状态交互。 <dt>#WALLPAPER_SERVICE (“壁纸”) <dd> A android.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 用于控制键卫。 <dt>#LOCATION_SERVICE (“location”) <dd> A android.location.LocationManager 用于控制位置(例如 GPS)更新。 <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 ,用于处理网络连接管理。 <dt>#IPSEC_SERVICE (“ipsec”) <dd> A android.net.IpSecManager IpSecManager ,用于管理套接字和网络上的 IPSec。 <dt>#WIFI_SERVICE (“wifi”) <dd> A android.net.wifi.WifiManager WifiManager ,用于管理 Wi-Fi 连接。 在 Android 7 之前的版本中,它只能从应用程序上下文获取,而不是从任何其他派生上下文中获取,以避免调用过程中的内存泄漏。 <dt>#WIFI_AWARE_SERVICE (“wifiaware”) <dd> A android.net.wifi.aware.WifiAwareManager WifiAwareManager ,用于管理 Wi-Fi 感知发现和连接。 <dt>#WIFI_P2P_SERVICE (“wifip2p”) <dd> A android.net.wifi.p2p.WifiP2pManager WifiP2pManager ,用于管理 Wi-Fi 直接连接。 <dt>#INPUT_METHOD_SERVICE (“input_method”) <dd> 用于管理输入法的 An android.view.inputmethod.InputMethodManager InputMethodManager 。 <dt>#UI_MODE_SERVICE (“uimode”) <dd> 用于控制 UI 模式的 An android.app.UiModeManager 。 <dt>#DOWNLOAD_SERVICE (“download”) <dd> A android.app.DownloadManager 用于请求 HTTP 下载 <dt (“batterymanager”) <dd> A android.os.BatteryManager 用于管理电池状态 <dt>#JOB_SCHEDULER_SERVICE>#BATTERY_SERVICE (“taskmanager”) <dd> A 用于管理计划任务 <dt>#NETWORK_STATS_SERVICE (“netstats”) <dd> A android.app.job.JobSchedulerandroid.app.usage.NetworkStatsManager NetworkStatsManager,用于查询网络使用情况统计信息。 <dt>#HARDWARE_PROPERTIES_SERVICE (“hardware_properties”) <用于访问硬件属性的 dd> A android.os.HardwarePropertiesManager 。 <dt>#DOMAIN_VERIFICATION_SERVICE (“domain_verification”) <用于访问 Web 域审批状态的 dd> A android.content.pm.verify.domain.DomainVerificationManager 。 <dt>#DISPLAY_HASH_SERVICE (“display_hash”) <dd> A android.view.displayhash.DisplayHashManager ,用于管理显示哈希。 <dt>#AUTHENTICATION_POLICY_SERVICE (“authentication_policy”) <dd> A android.security.authenticationpolicy.AuthenticationPolicyManager ,用于管理设备上的身份验证相关策略。 </dl>

注意:通过此 API 获取的系统服务可能与从中获取它们的上下文紧密关联。 通常,不要在各种不同上下文(活动、应用程序、服务、提供程序等)之间共享服务对象。

注意:返回 true 的即时应用PackageManager#isInstantApp()无权访问以下系统服务:#DEVICE_POLICY_SERVICE、、、#FINGERPRINT_SERVICE、#KEYGUARD_SERVICE#SHORTCUT_SERVICE#USB_SERVICE、#WALLPAPER_SERVICE、#WIFI_P2P_SERVICE、 、 。 #WIFI_SERVICE#WIFI_AWARE_SERVICE 对于这些服务,此方法将返回 null。 通常,如果作为即时应用运行,应始终检查此方法的结果。null

注意:在实现此方法时,请记住,可以在较新的 Android 版本中添加新服务,因此,如果只查找上述显式名称,请确保在无法识别名称 &mdash 时返回 null ;如果引发 RuntimeException 异常,则应用可能会在新的 Android 版本中中断。

Java文档android.content.Context.getSystemService(java.lang.String)。

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

另请参阅

适用于