OrientationSensor.ReportInterval Propriedade
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.
Obtém ou define o intervalo de relatório com suporte pelo sensor.
public:
property unsigned int ReportInterval { unsigned int get(); void set(unsigned int value); };
uint32_t ReportInterval();
void ReportInterval(uint32_t value);
public uint ReportInterval { get; set; }
var uInt32 = orientationSensor.reportInterval;
orientationSensor.reportInterval = uInt32;
Public Property ReportInterval As UInteger
Valor da propriedade
O intervalo de relatório compatível com o sensor, em milissegundos.
Comentários
O intervalo de relatório é definido como um valor padrão que varia de acordo com a implementação do driver do sensor. Se o aplicativo não quiser usar esse valor padrão, defina o intervalo de relatório como um valor diferente de zero antes de registrar um manipulador de eventos ou chamar GetCurrentReading. Em seguida, o sensor tenta alocar recursos para atender aos requisitos do aplicativo, equilibrando as necessidades de outros aplicativos usando o sensor.
As alterações no intervalo de relatório depois que um manipulador de eventos tiver sido registrado ou GetCurrentReading tiver sido chamado podem se aplicar à entrega de leituras subsequentes do sensor.
Por outro lado, quando um aplicativo é concluído com o sensor, ele deve retornar explicitamente o sensor para seu intervalo de relatório padrão definindo-o como zero. Isso é importante para a conservação de energia, especialmente ao usar uma linguagem que pode manter o objeto sensor ativo por um período indefinido antes da coleta de lixo.
O aplicativo deve consultar a propriedade MinimumReportInterval antes de definir o intervalo de relatório para garantir que o sensor possa respeitar o intervalo de relatório solicitado. Definir um valor abaixo do intervalo mínimo com suporte dispara uma exceção ou tem resultados indefinidos.
Embora o aplicativo possa definir esse valor para solicitar um intervalo de relatório específico, o driver determina o intervalo de relatório real, com base na lógica interna. Por exemplo, o driver pode usar o intervalo de relatório mais curto solicitado por qualquer chamador.
Se o valor for definido como zero, o driver usará seu intervalo de relatório padrão. Assim como ocorre com a solicitação de um intervalo específico, o driver pode escolher um intervalo diferente com base em outras solicitações de cliente e lógica interna.
A plataforma de sensor define automaticamente a sensibilidade de alteração para sensores de orientação com base no intervalo de relatório atual. Esta tabela especifica os valores de confidencialidade de alteração para determinados intervalos.
Intervalo de relatório atual | Alterar sensibilidade |
---|---|
1 ms – 16 ms | 0,01 graus |
17 ms – 32 ms | 0,5 graus |
>= 33 ms | 2 graus |