PowerManager.GetThermalHeadroom(Int32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece uma estimativa de quanto espaço térmico o dispositivo tem atualmente antes de atingir uma limitação severa.
[Android.Runtime.Register("getThermalHeadroom", "(I)F", "GetGetThermalHeadroom_IHandler", ApiSince=30)]
public virtual float GetThermalHeadroom(int forecastSeconds);
[<Android.Runtime.Register("getThermalHeadroom", "(I)F", "GetGetThermalHeadroom_IHandler", ApiSince=30)>]
abstract member GetThermalHeadroom : int -> single
override this.GetThermalHeadroom : int -> single
Parâmetros
- forecastSeconds
- Int32
quantos segundos no futuro a serem previstos. Dado que as condições do dispositivo podem mudar a qualquer momento, as previsões de mais adiante no futuro provavelmente serão menos precisas do que as previsões em um futuro próximo.
Retornos
um valor maior ou igual a 0,0, em que 1,0 indica o limite de limitação GRAVE, conforme descrito acima. Retornará NaN se o dispositivo não der suporte a essa funcionalidade.
- Atributos
Comentários
Fornece uma estimativa de quanto espaço térmico o dispositivo tem atualmente antes de atingir uma limitação severa.
Observe que isso só tenta rastrear o espaço para a cabeça de sensores de movimento lento, como o sensor de temperatura da pele. Isso significa que não há nenhum benefício em chamar essa função com mais frequência do que cerca de uma vez por segundo e as tentativas de chamar com mais frequência podem resultar no retorno NaNda função.
Além disso, para poder fornecer uma previsão precisa, o sistema não tenta prever até que tenha várias amostras de temperatura das quais extrapolar. Isso deve levar apenas alguns segundos a partir do momento da primeira chamada, mas durante esse tempo, nenhuma previsão ocorrerá e o espaço na cabeça atual será retornado independentemente do valor de forecastSeconds.
O valor retornado é um float não negativo que representa quanto do envelope térmico está em uso (ou é previsto para estar em uso). Um valor de 1.0 indica que o dispositivo é (ou será) limitado em #THERMAL_STATUS_SEVERE. Essa limitação pode afetar a CPU, a GPU e outros subsistemas. Os valores podem exceder 1,0, mas não há nenhum mapeamento implícito para níveis de status térmico específicos além desse ponto. Isso significa que valores maiores que 1,0 podem corresponder, #THERMAL_STATUS_SEVEREmas também podem representar uma limitação mais pesada.
Um valor de 0,0 corresponde a uma distância fixa de 1,0, mas não corresponde a nenhum status térmico ou temperatura específico. Os valores em (0,0, 1,0] podem ser dimensionados linearmente com temperatura, embora as alterações de temperatura ao longo do tempo normalmente não sejam lineares. Os valores negativos serão fixados em 0,0 antes de retornar.
Java documentação para android.os.PowerManager.getThermalHeadroom(int).
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.