Context.GetSystemService 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
| 名称 | 说明 |
|---|---|
| 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)。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。
另请参阅
- WindowService
- IWindowManager
- LayoutInflaterService
- LayoutInflater
- ActivityService
- ActivityManager
- PowerService
- PowerManager
- AlarmService
- AlarmManager
- NotificationService
- NotificationManager
- KeyguardService
- KeyguardManager
- LocationService
- LocationManager
- SearchService
- SearchManager
- SensorService
- SensorManager
- StorageService
- StorageManager
- VibratorService
- Vibrator
- ConnectivityService
- ConnectivityManager
- WifiService
- WifiManager
- AudioService
- AudioManager
- MediaRouterService
- MediaRouter
- TelephonyService
- TelephonyManager
- TelephonySubscriptionService
- SubscriptionManager
- CarrierConfigService
- CarrierConfigManager
- InputMethodService
- InputMethodManager
- UiModeService
- UiModeManager
- DownloadService
- DownloadManager
- BatteryService
- BatteryManager
- JobSchedulerService
- JobScheduler
- NetworkStatsService
- NetworkStatsManager