Leanback

Leanback

คู่มือผู้ใช้  ตัวอย่างโค้ด

เอกสารอ้างอิง API
androidx.leanback.app
androidx.leanback.database
androidx.leanback.graphics
androidx.leanback.media
androidx.leanback.preference
androidx.leanback.system
androidx.leanback.Widget
androidx.leanback.widget.picker

ใช้ฟีเจอร์ Compose สำหรับทีวีแทนอาร์ติแฟกต์นี้

อัปเดตล่าสุด	รุ่นที่เสถียร	ตัวเลือกถอนการอ้างสิทธิ์	รุ่นเบต้า	รุ่นอัลฟ่า
15 พฤศจิกายน 2023	1.0.0	1.1.0-Rc02	-	1.2.0-alpha04

การประกาศทรัพยากร Dependency

ในการเพิ่มทรัพยากร Dependency สำหรับ Leanback คุณต้องเพิ่มที่เก็บ Google Maven ไปยัง อ่านที่เก็บ Maven ของ Google เพื่อดูข้อมูลเพิ่มเติม

เพิ่มทรัพยากร Dependency สำหรับอาร์ติแฟกต์ที่คุณต้องการในไฟล์ build.gradle สำหรับ ในแอปหรือโมดูล

Groovy

dependencies {
    def leanback_version = "1.2.0-alpha04"

    implementation "androidx.leanback:leanback:$leanback_version"

    // leanback-preference is an add-on that provides a settings UI for TV apps.
    implementation "androidx.leanback:leanback-preference:$leanback_version"

    // leanback-paging is an add-on that simplifies adding paging support to a RecyclerView Adapter.
    implementation "androidx.leanback:leanback-paging:1.1.0-alpha11"

    // leanback-tab is an add-on that provides customized TabLayout to be used as the top navigation bar.
    implementation "androidx.leanback:leanback-tab:1.1.0-beta01"
}

Kotlin

dependencies {
    val leanback_version = "1.2.0-alpha04"

    implementation("androidx.leanback:leanback:$leanback_version")

    // leanback-preference is an add-on that provides a settings UI for TV apps.
    implementation("androidx.leanback:leanback-preference:$leanback_version")

    // leanback-paging is an add-on that simplifies adding paging support to a RecyclerView Adapter.
    implementation("androidx.leanback:leanback-paging:1.1.0-alpha11")

    // leanback-tab is an add-on that provides customized TabLayout to be used as the top navigation bar.
    implementation("androidx.leanback:leanback-tab:1.1.0-beta01")
}

ดูข้อมูลเพิ่มเติมเกี่ยวกับทรัพยากร Dependency ได้ที่หัวข้อเพิ่มการอ้างอิงของบิลด์

ความคิดเห็น

ความคิดเห็นของคุณช่วยปรับปรุง Jetpack ให้ดียิ่งขึ้น โปรดแจ้งให้เราทราบหากคุณพบปัญหาใหม่หรือมี ไอเดียในการปรับปรุงไลบรารีนี้ โปรดดูที่ ปัญหาที่มีอยู่ ในไลบรารีนี้ก่อนที่จะสร้างใหม่ คุณสามารถเพิ่มการโหวตให้กับปัญหาที่มีอยู่ได้โดย คลิกปุ่มดาว

สร้างรายการใหม่

ดูเอกสารประกอบเกี่ยวกับเครื่องมือติดตามปัญหา เพื่อดูข้อมูลเพิ่มเติม

Leanback-Grid เวอร์ชัน 1.0.0

เวอร์ชัน 1.0.0-alpha03

15 พฤศจิกายน 2023

ปล่อย androidx.leanback:leanback-grid:1.0.0-alpha03 แล้ว เวอร์ชัน 1.0.0-alpha03 มีคอมมิตเหล่านี้

การอัปเดตการขึ้นต่อกัน

• อัปเดตเพื่อใช้ RecyclerView 1.3.2 เพื่อแก้ไขข้อขัดข้องที่พบบ่อยในแอป TV (I2c3a0, b/292114537)

เวอร์ชัน 1.0.0-alpha02

6 กันยายน 2023

ปล่อย androidx.leanback:leanback-grid:1.0.0-alpha02 แล้ว เวอร์ชัน 1.0.0-alpha02 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• ตั้งค่า setFocusOutAllowed เป็นแบบสาธารณะเพื่อให้ตั้งค่าพร็อพเพอร์ตี้ที่ใช้มุ่งเน้นได้แบบเป็นโปรแกรม (Iebd99)

แก้ไขข้อบกพร่อง

• ตรวจสอบว่าบริการ a11y พิจารณาตารางกริดเป็นตารางกริดโดยตั้งชื่อคลาสข้อมูลโหนด a11y (I12812)
• เพิ่มเสียงการนำทางที่ขาดหายไปเมื่อเลื่อนลงเพื่อการเลื่อนอย่างราบรื่น (f49767)

เวอร์ชัน 1.0.0-alpha01

17 พฤศจิกายน 2021

ปล่อย androidx.leanback:leanback-grid:1.0.0-alpha01 แล้ว เวอร์ชัน 1.0.0-alpha01 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• ย้ายชั้นเรียน/อินเทอร์เฟซต่อไปนี้จาก leanback ไปยังไลบรารี leanback-grid ใหม่แล้ว: BaseGridView, FacetProvider, FacetProviderAdapter, GridLayoutManager, HorizontalGridView, ItemAlignmentFacet, OnChildLaidOutListener, OnChildSelectedListener, OnChildViewHolderSelectedListener, VerticalGridView, ViewHolderTask, Visibility การเปลี่ยนแปลงนี้จะรักษาความเข้ากันได้ของไบนารีไว้ ทุกคนที่ต้องการใช้เพียงคอมโพเนนต์มุมมองตารางกริดของ Leanback จะใช้ leanback-grid เป็นทรัพยากร Dependency ได้โดยตรง (If1e49)

Leanback Leanback-Preference เวอร์ชัน 1.2.0

เวอร์ชัน 1.2.0-alpha04

15 พฤศจิกายน 2023

ปล่อย androidx.leanback:leanback:1.2.0-alpha04 และ androidx.leanback:leanback-preference:1.2.0-alpha04 แล้ว เวอร์ชัน 1.2.0-alpha04 มีคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

• (I2c3a0, b/292114537)

การอัปเดตการขึ้นต่อกัน

• อัปเดตข้อกำหนด Recyclerview เป็นเวอร์ชัน 1.3.2 เพื่อแก้ไขข้อขัดข้องที่พบบ่อยในแอปทีวี

เวอร์ชัน 1.2.0-alpha03

6 กันยายน 2023

ปล่อย androidx.leanback:leanback:1.2.0-alpha03 และ androidx.leanback:leanback-preference:1.2.0-alpha03 แล้ว เวอร์ชัน 1.2.0-alpha03 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เพิ่ม GuidedActionAppCompatEditText เพื่อรองรับธีม AppCompat ได้ดียิ่งขึ้น (ab7cf1, dc954d)

เวอร์ชัน 1.2.0-alpha02

17 พฤศจิกายน 2021

ปล่อย androidx.leanback:leanback:1.2.0-alpha02 และ androidx.leanback:leanback-preference:1.2.0-alpha02 แล้ว เวอร์ชัน 1.2.0-alpha02 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• ย้ายชั้นเรียน/อินเทอร์เฟซต่อไปนี้จาก leanback ไปยังไลบรารี leanback-grid ใหม่แล้ว: BaseGridView, FacetProvider, FacetProviderAdapter, GridLayoutManager, HorizontalGridView, ItemAlignmentFacet, OnChildLaidOutListener, OnChildSelectedListener, OnChildViewHolderSelectedListener, VerticalGridView, ViewHolderTask, Visibility การเปลี่ยนแปลงนี้จะรักษาความเข้ากันได้ของไบนารีไว้ ทุกคนที่ต้องการใช้เพียงคอมโพเนนต์มุมมองตารางกริดของ Leanback จะใช้ leanback-grid เป็นทรัพยากร Dependency ได้โดยตรง (If1e49)

เวอร์ชัน 1.2.0-alpha01

21 กรกฎาคม 2021

ปล่อย androidx.leanback:leanback:1.2.0-alpha01 และ androidx.leanback:leanback-preference:1.2.0-alpha01 แล้ว เวอร์ชัน 1.2.0-alpha01 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• ทำให้ Leanback GridLayoutManager เป็นแบบสาธารณะและแลกเปลี่ยนได้ใน BaseGridView (f316b5)

การเปลี่ยนแปลง API

• ทำให้ Leanback GridLayoutManager เป็นแบบสาธารณะและแลกเปลี่ยนได้ใน BaseGridView (f316b5)

เวอร์ชัน 1.1.0

Leanback เวอร์ชัน 1.1.0-rc02

21 กรกฎาคม 2021

ปล่อย androidx.leanback:leanback:1.1.0-rc02 แล้ว เวอร์ชัน 1.1.0-rc02 มีคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

• แก้ไขข้อบกพร่องพื้นหลังส่วนย่อยของรายละเอียด (40d8e3)

Leanback Leanback-Preference เวอร์ชัน 1.1.0-rc01

7 เมษายน 2021

ปล่อย androidx.leanback:leanback:1.1.0-rc01 และ androidx.leanback:leanback-preference:1.1.0-rc01 แล้ว เวอร์ชัน 1.1.0-rc01 มีคอมมิตเหล่านี้

• แก้ไขการรั่วไหลของมุมมองใน SearchSupportFragment() (6c47a1, b/171909417)
• กำหนดให้มีโปรแกรมจดจำเสียงพูดเป็นไม่บังคับสำหรับ SearchSupportFragment (4ff949,b/169936953)

Leanback-Paging เวอร์ชัน 1.1

เวอร์ชัน 1.1.0-alpha11

15 พฤศจิกายน 2023

เผยแพร่ androidx.leanback:leanback-paging:1.1.0-alpha11 แล้วโดยไม่มีการเปลี่ยนแปลง เวอร์ชัน 1.1.0-alpha11 มีคอมมิตเหล่านี้

เวอร์ชัน 1.1.0-alpha10

6 กันยายน 2023

ปล่อย androidx.leanback:leanback-paging:1.1.0-alpha10 แล้ว เวอร์ชัน 1.1.0-alpha10 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• อัปเดตหน้า Leanback เป็น Paging 3.1.0 (882ed1)

Leanback-Paging เวอร์ชัน 1.1.0-alpha09

17 พฤศจิกายน 2021

ปล่อย androidx.leanback:leanback-paging:1.1.0-alpha09 แล้ว เวอร์ชัน 1.1.0-alpha09 มีคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

• อัปเดตเพื่อใช้ API การแบ่งหน้าล่าสุดแล้ว

Leanback-Paging เวอร์ชัน 1.1.0-alpha08

21 กรกฎาคม 2021

ปล่อย androidx.leanback:leanback-paging:1.1.0-alpha08 แล้ว เวอร์ชัน 1.1.0-alpha08 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เพิ่ม API .peek() และ .snapshot() รายการไปยัง PagingDataAdapter ซึ่งช่วยให้ตรวจสอบข้อมูลที่นำเสนอได้โดยไม่ต้องเรียกใช้การดึงข้อมูลหน้าเว็บ (Ic8917)

Leanback-Paging เวอร์ชัน 1.1.0-alpha07

13 มกราคม 2021

ปล่อย androidx.leanback:leanback-paging:1.1.0-alpha07 แล้ว เวอร์ชัน 1.1.0-alpha07 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• อัปเดตคุณสมบัติด้านความสะดวก CombinedLoadStates.refresh CombinedLoadStates.prepend CombinedLoadStates.append เพื่อเปลี่ยนจาก Loading เป็น NotLoading เท่านั้น หลังจากสถานะการโหลดของสื่อกลางและแหล่งที่มาเป็น NotLoading เพื่อให้แน่ใจว่า นำการอัปเดตระยะไกลไปใช้แล้ว (I65619)

Leanback-Tab ค่ากำหนด Leanback เวอร์ชัน 1.1.0-เบต้า01

2 ธันวาคม 2020

ปล่อย androidx.leanback:leanback:1.1.0-beta01, androidx.leanback:leanback-preference:1.1.0-beta01 และ androidx.leanback:leanback-tab:1.1.0-beta01 แล้ว เวอร์ชัน 1.1.0-beta01 มีการคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

• แก้ไขการรั่วไหลของมุมมองเมื่อพุช VerticalGridSupportFragment ไปยัง Backstack (Iaac69, b/171909417)
• แก้ไขการรั่วไหลของมุมมองเมื่อพุช BrowseSupportFragment ไปยัง Backstack (I34483, b/171909417)
• แก้ไขการรั่วไหลของมุมมองเมื่อพุช DetailsSupportFragment ไปยัง Backstack (Ifec9e, b/171909417)
• แก้ไขการรั่วไหลของมุมมองเมื่อพุช RowsSupportFragment ไปยัง Backstack (I985d4, b/171909417)
• แก้ไขภาพเคลื่อนไหวการเปลี่ยนพื้นหลังของ GuideStepSupportFragment (I86d15, b/173647688)
• แก้ไข IllegalArgumentException เมื่อกู้คืน guidStepSupportFragment (Ic829f, b/172000115)
• แก้ไข GridLayoutManager NullPointerException ใน findContainingItemView() เมื่อ clearFocus() (Id0e42)

Leanback-Paging เวอร์ชัน 1.1.0-alpha06

2 ธันวาคม 2020

ปล่อย androidx.leanback:leanback-paging:1.1.0-alpha06 แล้ว เวอร์ชัน 1.1.0-alpha06 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• นำ API dataRefreshFlow / dataRefreshListener ออกแล้ว เพราะซ้ำซ้อนกับการอัปเดต requestStateFlow / Listener สำหรับ ที่ย้ายข้อมูลทั้งหมด ค่าเทียบเท่าloadStateFlow คือ

  loadStateFlow.distinctUntilChangedBy { it.refresh }
      .filter { it.refresh is NotLoading }
  

  (Ib5570, b/173530908)

• เมธอด dataRefreshFlow / Listener ที่เลิกใช้งานโดยสมบูรณ์ด้วย แทนที่ด้วยอนุประโยค (I6e2dd)

เวอร์ชัน 1.1.0-alpha05

1 ตุลาคม 2020

ปล่อย androidx.leanback:leanback-*:1.1.0-alpha05 แล้ว เวอร์ชัน 1.1.0-alpha05 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• ให้การนำทางของ A11Y ทำงานตามแอตทริบิวต์ GridLayoutManager policyOutFront และ และFocusOutEnd (b/161390258)

แก้ไขข้อบกพร่อง

• แก้ไข "ดูรั่วไหล" ใน GuidanceStylist.onDestroyView() (b/164841457)
• แก้ไข ConcatAdapter ใน GridLayoutManager (b/165694295)
• leanback-tab: การปรับปรุง Javadoc และการเปลี่ยนโครงสร้างโค้ดเล็กน้อย (aosp/1393383)
• นำเมธอด setRecyclerView ออกจาก API ที่เพิ่มไว้เมื่อเลิกใช้งานเมธอดเดียวกันใน RecyclerView อัปเดต Lebback lib เพื่อใช้เมธอด addRecyclerListener API ใหม่ของ RecyclerView (I14798)

เวอร์ชัน 1.1.0-alpha04

11 สิงหาคม 2020

ปล่อย androidx.leanback:leanback:1.1.0-alpha04, androidx.leanback:leanback-paging:1.1.0-alpha04, androidx.leanback:leanback-preference:1.1.0-alpha04 และ androidx.leanback:leanback-tab:1.1.0-alpha04 แล้ว เวอร์ชัน 1.1.0-alpha04 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• LeanbackTabLayout มีการนำทางด้านบน (โดยปกติจะแสดงในแนวนอนที่ด้านบนของแอป) ในประสบการณ์การเรียกดู
• การแบ่งหน้าสำหรับ Leanback ทำให้การเพิ่มการรองรับการแบ่งหน้าใน RecyclerView.Adapter ง่ายขึ้น
• เพิ่มธีมที่เข้ากันได้กับ App Campaign สำหรับ Leanback ซึ่งจะทำให้สร้างฐานโค้ดเดียวระหว่างอุปกรณ์เคลื่อนที่และทีวีได้ง่ายขึ้น

การเปลี่ยนแปลง API

• เพิ่มอะแดปเตอร์โดยอิงตาม asyncpagingdatadiffer สําหรับ Leanback วิดเจ็ต (If0dfe)
• การเพิ่ม TabLayout ที่กำหนดเองเพื่อใช้เป็นแถบนำทางด้านบน ใน Leanback (I1e304)

เวอร์ชัน 1.1.0-alpha03

18 ธันวาคม 2019

ปล่อย androidx.leanback:leanback:1.1.0-alpha03 และ androidx.leanback:leanback-preference:1.1.0-alpha03 แล้ว Leanback เวอร์ชัน 1.1.0-alpha03 จะมีคอมมิตเหล่านี้ และ Leanback-Preference เวอร์ชัน 1.1.0-alpha03 จะมีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• BaseGridView รองรับความเร็วในการเลื่อนแบบกำหนดเองแล้ว (aosp/952718)
• ทำให้แตะรายการขั้นตอนพร้อมคำแนะนำได้ง่ายขึ้น (aosp/1167964)
• เปิดเผย BaseGridView OnLayoutCompleteListener เพื่อให้แอปทำการแปลง View ได้หลังจากเลย์เอาต์ผ่าน (aosp/1164409)

การเปลี่ยนแปลง API

• เพิ่ม API ใหม่เพื่อรองรับความเร็วในการเลื่อน BaseGridView ที่กำหนดเอง (aosp/952718)
• เพิ่ม API ใหม่เพื่อเพิ่ม OnLayoutCompleteListener ใน BaseGridView (aosp/1164409)

แก้ไขข้อบกพร่อง

• แก้ไขข้อบกพร่องที่ Fast Layout Pass ไม่อัปเดตการจัดข้อความย่อย (aosp/1122745)
• แก้ไขข้อขัดข้องที่ซ้ำซ้อนในวิดเจ็ตเครื่องมือเลือกเมื่อเปลี่ยนโฟกัส (aosp/1168473)

การเปลี่ยนแปลงการขึ้นต่อกัน

• ค่ากำหนด Leanback: ปักหมุดการใช้ androidx.preference เป็น 1.1.0 (aosp/1181902)

เวอร์ชัน 1.1.0-alpha02

7 พฤษภาคม 2019

ปล่อย androidx.leanback:leanback:1.1.0-alpha02 และ androidx.leanback:leanback-preference:1.1.0-alpha02 แล้ว คอมมิตที่รวมอยู่ในเวอร์ชันนี้จะทำได้ที่การคอมมิต Leanback และการคอมมิต Leanback-preference

ฟีเจอร์ใหม่

• ตอนนี้ RowsSupportFragment ได้รับอนุญาตให้แชร์ ViewHolders กับ RowsSupportFragments อื่นๆ ได้แล้ว ซึ่งจะช่วยปรับปรุงประสิทธิภาพของ UI แบบหลายแท็บ

การเปลี่ยนแปลง API

• เพิ่ม PlaybackSupportFragment.setShowOrHideControlsOverlayOnUserInteraction() เพื่ออนุญาตให้แอปปิดใช้/ซ่อน/แสดงตัวควบคุมการเล่นโดยอัตโนมัติเมื่อกด DPAD

แก้ไขข้อบกพร่อง

• แก้ไขธีมของ Fragments ค่ากำหนด Leanback ที่เสียหายเนื่องจากการเปลี่ยนแปลงในไลบรารีค่ากำหนด
• แก้ไขข้อบกพร่องในการนำทางเมื่อกดแป้น "ย้อนกลับ" บน SearchEditText

เวอร์ชัน 1.1.0-alpha01

30 มกราคม 2019

ปล่อย androidx.leanback:leanback 1.1.0-alpha01 แล้ว

ฟีเจอร์ใหม่

• เพิ่มวิดเจ็ต Pin Picker แล้ว
• ปิดใช้การตัดโครงร่างไว้โดยค่าเริ่มต้นในอุปกรณ์ที่มีหน่วยความจำต่ำ
• การควบคุมการแสดง/ซ่อนการควบคุม PlaybackSupportFragment ที่ปรับแต่งเองซึ่งได้รับอนุญาต (b/122918400)

การเปลี่ยนแปลง API

• เลิกใช้งานส่วนย่อยของเฟรมเวิร์กแล้ว
• คลาส Pin Picker ใหม่

แก้ไขข้อบกพร่อง

• แก้ไขข้อขัดข้องของธุรกรรมส่วนย่อยหลังจากที่ BrowseSupportFragment หยุดทำงาน
• GuidedStepSupportFragment ไม่ควรตัดคลิปรายการใน VerticalGridView (aosp/787396)
• onCreateActionsStylist() และ onCreateGuidanceStylist() ถูกย้ายจากเครื่องมือสร้างไปที่ GuidedSupportFragment.onCreate() (aosp/787397)
• แก้ไขข้อบกพร่องที่ทำให้ SearchSupportFragment โฟกัสที่ส่วนย่อยผลลัพธ์ไม่ได้ (aosp/798833)
• แก้ไขข้อบกพร่องการเลื่อนใน VerticalGridView และ HorizontalGridView (aosp/858809)

ปล่อย androidx.leanback-preference 1.1.0-alpha01 แล้ว

ฟีเจอร์ใหม่

• เพิ่มคลาส Fragment ของ androidx, คลาส Fragment เฟรมเวิร์กที่เลิกใช้งานแล้ว
• ตอนนี้สีและแบบอักษรจะขึ้นอยู่กับแอตทริบิวต์ธีมเฟรมเวิร์ก

การเปลี่ยนแปลง API

• คลาสส่วนย่อย androidx ใหม่, คลาสส่วนย่อยเฟรมเวิร์กถูกเลิกใช้งาน