diff --git a/docs/html/preview/api-overview.jd b/docs/html/preview/api-overview.jd index f2bc11136d581..3373fc4a9c35d 100644 --- a/docs/html/preview/api-overview.jd +++ b/docs/html/preview/api-overview.jd @@ -18,6 +18,7 @@ page.image=images/cards/card-n-apis_2x.png
  • Quick Path to App Install
  • Doze on the Go
  • Background Optimizations
  • +
  • SurfaceView
  • Data Saver
  • Vulkan API
  • Quick Settings Tile API
  • @@ -286,6 +287,32 @@ your app is receiving these, take advantage of the N Developer Preview to Optimizations documentation for details.

    +

    SurfaceView

    +

    +Android N brings synchronous movement to the {@link android.view.SurfaceView} +class, which provides better battery performance +than {@link android.view.TextureView} in certain cases: When rendering video or +3D content, apps with scrolling and animated video position use less power with +{@link android.view.SurfaceView} than with {@link android.view.TextureView}. +

    + +The {@link android.view.SurfaceView} class enables more battery-efficient compositing on +screen, because it is composited in dedicated hardware, separately from app +window content. As a result, it makes fewer intermediate +copies than {@link android.view.TextureView}. +

    + +

    +A {@link android.view.SurfaceView} object's content position is now updated synchronously +with the containing app content. One result of this change is that simple +translations or scales of a video playing in a {@link android.view.SurfaceView} +no longer produce black bars alongside the view as it moves. +

    + +

    +Starting with Android N, we strongly recommend that you save power by using +{@link android.view.SurfaceView} instead of {@link android.view.TextureView}. +

    Data Saver