OrientationSensor.GetDefault 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.
Sobrecargas
GetDefault() |
Retorna o sensor de orientação padrão para leituras absolutas. |
GetDefault(SensorReadingType) |
Retorna o sensor de orientação padrão, levando em conta as preferências de precisão. |
GetDefault(SensorReadingType, SensorOptimizationGoal) |
Retorna o sensor de orientação padrão, levando em conta as preferências de energia e precisão. |
GetDefault()
Retorna o sensor de orientação padrão para leituras absolutas.
public:
static OrientationSensor ^ GetDefault();
static OrientationSensor GetDefault();
/// [Windows.Foundation.Metadata.Overload("GetDefault")]
static OrientationSensor GetDefault();
public static OrientationSensor GetDefault();
[Windows.Foundation.Metadata.Overload("GetDefault")]
public static OrientationSensor GetDefault();
function getDefault()
Public Shared Function GetDefault () As OrientationSensor
Retornos
O sensor de orientação padrão ou nulo se nenhum sensor de orientação for encontrado.
- Atributos
Exemplos
O exemplo a seguir demonstra como um aplicativo UWP criado com XAML e C# usou esse método para estabelecer uma conexão com o sensor de orientação.
_sensor = OrientationSensor.GetDefault();
Comentários
Esse método retorna o mesmo resultado que GetDefault(SensorReadingType.Absolute)
Esse método retorna apenas valores para hardware que foi integrado ao computador pelo fabricante. (As leituras de sensor de orientação são derivadas de vários sensores.) Um valor nulo será retornado se o sensor especificado não estiver disponível no sistema.
Quando um sistema estiver em Modo de Espera Conectado, uma chamada para o método GetDefault retornará imediatamente com um resultado nulo.
Confira também
Aplica-se a
GetDefault(SensorReadingType)
Retorna o sensor de orientação padrão, levando em conta as preferências de precisão.
public:
static OrientationSensor ^ GetDefault(SensorReadingType sensorReadingtype);
/// [Windows.Foundation.Metadata.Overload("GetDefaultWithSensorReadingType")]
static OrientationSensor GetDefault(SensorReadingType const& sensorReadingtype);
[Windows.Foundation.Metadata.Overload("GetDefaultWithSensorReadingType")]
public static OrientationSensor GetDefault(SensorReadingType sensorReadingtype);
function getDefault(sensorReadingtype)
Public Shared Function GetDefault (sensorReadingtype As SensorReadingType) As OrientationSensor
Parâmetros
- sensorReadingtype
- SensorReadingType
O tipo de sensor a ser recuperado. Um SensorReadingType Absoluto retorna um OrientationSensor usando um acelerômetro, um giromoter e um magnetômetro para determinar a orientação em relação ao Norte magnético. Um SensorReadingType relativo retorna um OrientationSensor usando apenas um acelerômetro e um girômetro (sem magnetômetro), medindo em relação ao local em que o sensor foi instanciado pela primeira vez."
Retornos
O sensor de orientação padrão ou nulo se nenhum sensor de orientação for encontrado.
- Atributos
Requisitos do Windows
Família de dispositivos |
Windows 10 Anniversary Edition (introduzida na 10.0.14393.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduzida na v3.0)
|
Comentários
Esse método retorna apenas valores para hardware que foi integrado ao computador pelo fabricante. (As leituras de sensor de orientação são derivadas de vários sensores.) Um valor nulo será retornado se o sensor especificado não estiver disponível no sistema.
Quando um sistema estiver em Modo de Espera Conectado, uma chamada para o método GetDefault retornará imediatamente com um resultado nulo .
Confira também
Aplica-se a
GetDefault(SensorReadingType, SensorOptimizationGoal)
Retorna o sensor de orientação padrão, levando em conta as preferências de energia e precisão.
public:
static OrientationSensor ^ GetDefault(SensorReadingType sensorReadingType, SensorOptimizationGoal optimizationGoal);
/// [Windows.Foundation.Metadata.Overload("GetDefaultWithSensorReadingTypeAndSensorOptimizationGoal")]
static OrientationSensor GetDefault(SensorReadingType const& sensorReadingType, SensorOptimizationGoal const& optimizationGoal);
[Windows.Foundation.Metadata.Overload("GetDefaultWithSensorReadingTypeAndSensorOptimizationGoal")]
public static OrientationSensor GetDefault(SensorReadingType sensorReadingType, SensorOptimizationGoal optimizationGoal);
function getDefault(sensorReadingType, optimizationGoal)
Public Shared Function GetDefault (sensorReadingType As SensorReadingType, optimizationGoal As SensorOptimizationGoal) As OrientationSensor
Parâmetros
- sensorReadingType
- SensorReadingType
O tipo de sensor a ser recuperado. Um SensorReadingType Absoluto retorna um OrientationSensor usando um acelerômetro, um giromoter e um magnetômetro para determinar a orientação em relação ao Norte magnético. Um SensorReadingType relativo retorna um OrientationSensor usando apenas um acelerômetro e um girômetro (sem magnetômetro), medindo em relação ao local em que o sensor foi instanciado pela primeira vez.
- optimizationGoal
- SensorOptimizationGoal
Indica as preferências de otimização para o sensor. Esse campo só será usado se um SensorReadingType absoluto for especificado. Um optimizationGoal of Precision retornará um OrientationSensor usando um acelerômetro, um girômetro e um magnetômetro para determinar a orientação em relação ao Norte magnético. Isso tem o potencial de usar muita energia devido ao uso de um girômetro. Por outro lado, especificar um optimizationGoal de PowerEfficiency retornará um OrientationSensor usando apenas um acelerômetro e magnetômetro (sem girômetro) para economizar energia ao custo de alguma precisão (as leituras ainda serão relativamente precisas na maioria das circunstâncias).
Retornos
O sensor de orientação padrão ou nulo se nenhum sensor de orientação for encontrado.
- Atributos
Requisitos do Windows
Família de dispositivos |
Windows 10 Anniversary Edition (introduzida na 10.0.14393.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduzida na v3.0)
|
Comentários
Esse método retorna apenas valores para hardware que foi integrado ao computador pelo fabricante. (As leituras de sensor de orientação são derivadas de vários sensores.) Um valor nulo será retornado se o sensor especificado não estiver disponível no sistema.
Quando um sistema estiver em Modo de Espera Conectado, uma chamada para o método GetDefault retornará imediatamente com um resultado nulo .
O parâmetro optimizationGoal depende do hardware disponível. Ele tentará escolher o melhor sensor disponível com base em sua preferência fornecida para otimização. Ele só terá efeito se o sensorReadingType for Absoluto.