Pular para o conteúdo

Mais visitados

Visitados recentemente

navigation

Rotary Input on Wear

Some Wear OS devices support rotary input, such as a rotating side button (RSB). When the user turns the button, your app's current view should scroll up or down.

If you are using ScrollView, ListView, HorizontalScrollView, or WearableRecyclerView in your app, then your app's view gets rotary input support by default. If you are using custom views other than those listed, or if you want to manually handle rotary input events, see Adding Custom Rotary Input Scrolling.

Refer to the following related resources:

Focus Best Practices

To respond to rotary input events, your scroll view must be in focus. In most cases, this happens automatically; your scrolling view becomes focused immediately after you create your Activity. However, there are situations where you need to manually handle focus of your app's view, such as:

Adding Custom Rotary Input Scrolling

If your scrollable view doesn't natively support rotary input scrolling, or if you want to do something other than scrolling in response to rotary input events (zoom in/out, turn dials, etc.), you can use the RotaryEncoder methods in the Wearable Support Library.

The following code snippet shows how to use RotaryEncoder to add custom scrolling in your app's view:

myView.setOnGenericMotionListener(new View.OnGenericMotionListener() {
    @Override
    public boolean onGenericMotion(View v, MotionEvent ev) {
        if (ev.getAction() == MotionEvent.ACTION_SCROLL && RotaryEncoder.isFromRotaryEncoder(ev)) {
            // Don't forget the negation here
            float delta = -RotaryEncoder.getRotaryAxisValue(ev) * RotaryEncoder.getScaledScrollFactor(
            getContext());

            // Swap these axes if you want to do horizontal scrolling instead
            scrollBy(0, Math.round(delta));

            return true;
        }

        return false;
    }
});

Testing Rotary Input Button on the Emulator

You can use the Android Emulator to simulate rotary input scrolling on a Wear device. Launch your Wear app on the emulator when you run your project, or drag an APK file onto the emulator to install it.

To test the rotary input on the emulator:

  1. From the SDK manager, use the SDK tools tab to get Android Emulator 26.0.3 or higher.
  2. Create an AVD (Android Virtual Device) with API 25.

    In Studio, select Tools>Android>AVD Manager. Create a new Wear device with API 25.

  3. Run the emulator from the Android Studio.
  4. Try rotary input scrolling.

    Click the overflow button (three dots at the bottom of the emulator toolbar). Click the Rotary input tab in the new window to open the rotary input interface.

The following video shows rotary input in the emulator:

Focus Behavior Tips

Este site usa cookies para armazenar suas preferências quanto às opções de idioma e exibição específicas ao site.

Receba as dicas e notícias mais recentes para desenvolvedores Android que ajudarão você a ter sucesso no Google Play.

* Campos obrigatórios

Uhu!

Siga o Google Developers no WeChat

Navegar neste site em ?

Você solicitou uma página em , mas sua preferência de idioma para este site está definida como .

Quer alterar sua preferência de idioma e navegar neste site em ? Para alterar a preferência de idioma depois, use o menu de idiomas na parte inferior de cada página.

É preciso ter o nível de API ou superior para esta aula

Este documento está oculto porque o nível de API selecionado para a documentação é o . Para alterar o nível, clique no seletor acima da barra de navegação esquerda.

Para mais informações sobre como especificar o nível de API que o seu app precisa, leia o artigo Compatibilidade com diferentes versões de plataforma.

Take a short survey?
Help us improve the Android developer experience. (April 2018 — Developer Survey)