Partilhar via


OrientationSensor.GetDefault Método

Definição

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.

Confira também

Aplica-se a