Context.GetSystemService Método

Definição

Sobrecargas

Nome Description
GetSystemService(String)

Retorne o identificador para um serviço no nível do sistema pelo nome.

GetSystemService(Class)

Retorne o identificador para um serviço no nível do sistema por classe.

GetSystemService(String)

Retorne o identificador para um serviço no nível do sistema pelo nome.

[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

Parâmetros

name
String

O nome do serviço desejado.

Retornos

O serviço ou null se o nome não existir.

Atributos

Comentários

Retorne o identificador para um serviço no nível do sistema pelo nome. A classe do objeto retornado varia de acordo com o nome solicitado. Os nomes disponíveis no momento são:

<dl><dt>#WINDOW_SERVICE ("window") <dd> O gerenciador de janelas de nível superior no qual você pode colocar janelas personalizadas. O objeto retornado é um android.view.WindowManager. Deve ser obtido apenas de um contexto visual, como Atividade ou um Contexto criado com #createWindowContext(int, Bundle), que são ajustados para a configuração e os limites visuais de uma área na tela. <dt>#LAYOUT_INFLATER_SERVICE ("layout_inflater") <dd> A android.view.LayoutInflater para inflar recursos de layout neste contexto. Deve ser obtido apenas de um contexto visual, como Atividade ou um Contexto criado com #createWindowContext(int, Bundle), que são ajustados para a configuração e os limites visuais de uma área na tela. <dt>#ACTIVITY_SERVICE ("atividade") <dd> A android.app.ActivityManager para interagir com o estado de atividade global do sistema. <dt>#WALLPAPER_SERVICE ("papel de parede") <dd> A android.service.wallpaper.WallpaperService para acessar papéis de parede neste contexto. Deve ser obtido apenas de um contexto visual, como Atividade ou um Contexto criado com #createWindowContext(int, Bundle), que são ajustados para a configuração e os limites visuais de uma área na tela. <dt>#POWER_SERVICE ("power") <dd> A android.os.PowerManager para controlar o gerenciamento de energia. <dt>#ALARM_SERVICE ("alarm") <dd> A android.app.AlarmManager para receber intenções no momento da sua escolha. <dt>#NOTIFICATION_SERVICE ("notification") <dd> A android.app.NotificationManager para informar o usuário sobre eventos em segundo plano. <dt>#KEYGUARD_SERVICE ("keyguard") <dd> A android.app.KeyguardManager para controlar o keyguard. <dt>#LOCATION_SERVICE ("location") <dd> A android.location.LocationManager para controlar atualizações de localização (por exemplo, GPS). <dt>#SEARCH_SERVICE ("search") <dd> A android.app.SearchManager para lidar com a pesquisa. <dt>#VIBRATOR_MANAGER_SERVICE ("vibrator_manager") <dd> A android.os.VibratorManager para acessar os vibradores do dispositivo, interagir com os individuais e reproduzir efeitos sincronizados em vários vibradores. <dt>#VIBRATOR_SERVICE ("vibrador") <dd> A android.os.Vibrator para interagir com o hardware do vibrador. <dt>#CONNECTIVITY_SERVICE ("conectividade") <dd> A android.net.ConnectivityManager ConnectivityManager para lidar com o gerenciamento de conexões de rede. <dt>#IPSEC_SERVICE ("ipsec") <dd> A android.net.IpSecManager IpSecManager para gerenciar IPSec em soquetes e redes. <dt>#WIFI_SERVICE ("wifi") <dd> A android.net.wifi.WifiManager WifiManager para gerenciamento de conectividade Wi-Fi. Em versões anteriores ao Android 7, ela só deve ser obtida de um contexto de aplicativo e não de qualquer outro contexto derivado para evitar vazamentos de memória dentro do processo de chamada. <dt>#WIFI_AWARE_SERVICE ("wifiaware") <dd> A android.net.wifi.aware.WifiAwareManager WifiAwareManager para gerenciamento de Wi-Fi Descoberta e conectividade conscientes. <dt>#WIFI_P2P_SERVICE ("wifip2p") <dd> A android.net.wifi.p2p.WifiP2pManager WifiP2pManager para gerenciamento de Wi-Fi conectividade direta. <dt>#INPUT_METHOD_SERVICE ("input_method") <dd> An android.view.inputmethod.InputMethodManager InputMethodManager para gerenciamento de métodos de entrada. <dt>#UI_MODE_SERVICE ("uimode") <dd> An android.app.UiModeManager para controlar modos de interface do usuário. <dt>#DOWNLOAD_SERVICE ("download") <dd> A android.app.DownloadManager para solicitar downloads <HTTP dt>#BATTERY_SERVICE ("batterymanager") <dd> A android.os.BatteryManager para gerenciar o dt<> de estado #JOB_SCHEDULER_SERVICEda bateria ("taskmanager") <dd> A android.app.job.JobScheduler para gerenciar tarefas <agendadas dt>#NETWORK_STATS_SERVICE ("netstats") <dd> A android.app.usage.NetworkStatsManager NetworkStatsManager para consultar estatísticas de uso da rede. <dt>#HARDWARE_PROPERTIES_SERVICE ("hardware_properties") <dd> A android.os.HardwarePropertiesManager para acessar propriedades de hardware. <dt>#DOMAIN_VERIFICATION_SERVICE ("domain_verification") <dd> A android.content.pm.verify.domain.DomainVerificationManager para acessar o estado de aprovação do domínio da Web. <dt>#DISPLAY_HASH_SERVICE ("display_hash") <dd> A android.view.displayhash.DisplayHashManager para gerenciamento de hashes de exibição. <dt>#AUTHENTICATION_POLICY_SERVICE ("authentication_policy") <dd> A android.security.authenticationpolicy.AuthenticationPolicyManager para gerenciar políticas relacionadas à autenticação no dispositivo. </dl>

Observação: os serviços do sistema obtidos por meio dessa API podem estar intimamente associados ao Contexto do qual são obtidos. Em geral, não compartilhe os objetos de serviço entre vários contextos diferentes (Atividades, Aplicativos, Serviços, Provedores etc.)

Observação: os aplicativos instantâneos, para os quais PackageManager#isInstantApp() retorna true, não têm acesso aos seguintes serviços do sistema: #DEVICE_POLICY_SERVICE, , #FINGERPRINT_SERVICE, #KEYGUARD_SERVICE, #SHORTCUT_SERVICE, #USB_SERVICE, , #WALLPAPER_SERVICE, #WIFI_P2P_SERVICE, #WIFI_SERVICE. #WIFI_AWARE_SERVICE Para esses serviços, esse método retornará null. Geralmente, se você estiver executando como um aplicativo instantâneo, sempre deverá verificar se o resultado desse método é null.

Observação: ao implementar esse método, tenha em mente que novos serviços podem ser adicionados em versões mais recentes do Android, portanto, se você estiver procurando apenas os nomes explícitos mencionados acima, lembre-se de retornar null quando você não reconhecer o nome — se você lançar uma RuntimeException exceção em vez disso, seu aplicativo poderá interromper novas versões do Android.

Java documentação para android.content.Context.getSystemService(java.lang.String).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Confira também

Aplica-se a

GetSystemService(Class)

Retorne o identificador para um serviço no nível do sistema por classe.

[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

Parâmetros

serviceClass
Class

A classe do serviço desejado.

Retornos

O serviço ou null se a classe não for um serviço de sistema com suporte. Observação: <b>nunca</b> gerará um RuntimeException se o nome não tiver suporte.

Atributos

Comentários

Retorne o identificador para um serviço no nível do sistema por classe.

As classes disponíveis atualmente são: android.view.WindowManager, , android.view.LayoutInflater, android.app.ActivityManager, android.os.PowerManager, android.app.AlarmManager, android.app.NotificationManager, android.app.KeyguardManager, android.location.LocationManager, android.app.SearchManager, android.os.Vibrator, , android.net.ConnectivityManagerandroid.net.wifi.WifiManager, android.media.AudioManager, android.media.MediaRouter, android.telephony.TelephonyManager, , android.telephony.SubscriptionManager, android.view.inputmethod.InputMethodManager, android.app.UiModeManager, android.app.DownloadManager, android.os.BatteryManager, android.app.job.JobScheduler, android.app.usage.NetworkStatsManager, , android.content.pm.verify.domain.DomainVerificationManagerandroid.view.displayhash.DisplayHashManagerandroid.security.authenticationpolicy.AuthenticationPolicyManager.

Observação: os serviços do sistema obtidos por meio dessa API podem estar intimamente associados ao Contexto do qual são obtidos. Em geral, não compartilhe os objetos de serviço entre vários contextos diferentes (Atividades, Aplicativos, Serviços, Provedores etc.)

Observação: os aplicativos instantâneos, para os quais PackageManager#isInstantApp() retorna true, não têm acesso aos seguintes serviços do sistema: #DEVICE_POLICY_SERVICE, , #FINGERPRINT_SERVICE, #KEYGUARD_SERVICE, #SHORTCUT_SERVICE, #USB_SERVICE, , #WALLPAPER_SERVICE, #WIFI_P2P_SERVICE, #WIFI_SERVICE. #WIFI_AWARE_SERVICE Para esses serviços, esse método retornará null. Geralmente, se você estiver executando como um aplicativo instantâneo, sempre deverá verificar se o resultado desse método é null.

Java documentação para android.content.Context.getSystemService(java.lang.Class<T>).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Aplica-se a