Media3 มี PlayerView เริ่มต้นซึ่งมีตัวเลือกการปรับแต่ง
บางอย่าง
ลบล้าง Drawables
PlayerView ใช้ PlayerControlView เพื่อแสดงตัวควบคุมการเล่นและแถบความคืบหน้า คุณสามารถลบล้าง Drawables ที่ PlayerControlView ใช้ด้วย Drawables ที่มีชื่อเดียวกันซึ่งกำหนดไว้ในแอปพลิเคชัน ดูรายการ Drawables ของตัวควบคุมที่ลบล้างได้ในเอกสารประกอบ
PlayerControlViewที่สามารถ
ลบล้างได้
นักพัฒนาแอปจะต้องติดตั้งใช้งานคอมโพเนนต์ UI ของตนเองสำหรับการปรับแต่งเพิ่มเติม อย่างไรก็ตาม แนวทางปฏิบัติแนะนำบางส่วนที่อาจช่วยคุณเริ่มต้นมีดังนี้
แนวทางปฏิบัติแนะนำ
เมื่อติดตั้งใช้งาน UI ของสื่อที่เชื่อมต่อกับ Media3 Player (เช่น
ExoPlayer, MediaController หรือการติดตั้งใช้งาน Player ที่กำหนดเอง) เราขอแนะนำให้แอปปฏิบัติตามแนวทางปฏิบัติแนะนำต่อไปนี้เพื่อให้ได้ประสบการณ์การใช้งาน UI ที่ดีที่สุด
ปุ่มเล่น/หยุดชั่วคราว
ปุ่มเล่นและหยุดชั่วคราวไม่ได้สอดคล้องกับสถานะของเพลเยอร์เพียงสถานะเดียวโดยตรง ตัวอย่างเช่น ผู้ใช้ควรจะสามารถเริ่มการเล่นใหม่ได้หลังจากที่การเล่นจบลงหรือล้มเหลว แม้ว่าเพลเยอร์จะไม่ได้หยุดชั่วคราวก็ตาม
Media3 มีเมธอดยูทิลิตีเพื่อตัดสินใจว่าจะแสดงปุ่มใด (Util.shouldShowPlayButton) และจัดการการกดปุ่ม (Util.handlePlayPauseButtonAction) เพื่อลดความซับซ้อนในการติดตั้งใช้งาน ดังนี้
Kotlin
val shouldShowPlayButton: Boolean = Util.shouldShowPlayButton(player) playPauseButton.setImageDrawable(if (shouldShowPlayButton) playDrawable else pauseDrawable) playPauseButton.setOnClickListener { Util.handlePlayPauseButtonAction(player) }
Java
boolean shouldShowPlayButton = Util.shouldShowPlayButton(player); playPauseButton.setImageDrawable(shouldShowPlayButton ? playDrawable : pauseDrawable); playPauseButton.setOnClickListener(view -> Util.handlePlayPauseButtonAction(player));
ฟังข้อมูลอัปเดตสถานะ
คอมโพเนนต์ UI ต้องเพิ่ม Player.Listener เพื่อรับทราบการเปลี่ยนแปลงสถานะที่ต้องมีการอัปเดต UI ที่เกี่ยวข้อง ดูรายละเอียดได้ที่ฟังเหตุการณ์การเล่น
events
การรีเฟรช UI อาจใช้ทรัพยากรมาก และเหตุการณ์ของเพลเยอร์หลายรายการมักจะมาพร้อมกัน โดยทั่วไปแล้ว การฟังเพียง onEvents และทริกเกอร์การอัปเดต UI จากตรงนั้นจะดีกว่าเพื่อหลีกเลี่ยงการรีเฟรช UI บ่อยเกินไปในช่วงเวลาสั้นๆ
Kotlin
player.addListener( object : Player.Listener { override fun onEvents(player: Player, events: Player.Events) { if ( events.containsAny( Player.EVENT_PLAY_WHEN_READY_CHANGED, Player.EVENT_PLAYBACK_STATE_CHANGED, Player.EVENT_PLAYBACK_SUPPRESSION_REASON_CHANGED, ) ) { updatePlayPauseButton() } if (events.containsAny(Player.EVENT_REPEAT_MODE_CHANGED)) { updateRepeatModeButton() } } } )
Java
player.addListener( new Player.Listener() { @Override public void onEvents(Player player, Player.Events events) { if (events.containsAny( Player.EVENT_PLAY_WHEN_READY_CHANGED, Player.EVENT_PLAYBACK_STATE_CHANGED, Player.EVENT_PLAYBACK_SUPPRESSION_REASON_CHANGED)) { updatePlayPauseButton(); } if (events.containsAny(Player.EVENT_REPEAT_MODE_CHANGED)) { updateRepeatModeButton(); } } });
จัดการคำสั่งที่ใช้ได้
คอมโพเนนต์ UI แบบอเนกประสงค์ที่อาจต้องทำงานร่วมกับการติดตั้งใช้งาน Player ที่แตกต่างกันควรตรวจสอบคำสั่งของเพลเยอร์ที่ใช้ได้เพื่อแสดงหรือซ่อนปุ่ม และเพื่อหลีกเลี่ยงการเรียกเมธอดที่ไม่รองรับ
Kotlin
nextButton.isEnabled = player.isCommandAvailable(COMMAND_SEEK_TO_NEXT)
Java
nextButton.setEnabled(player.isCommandAvailable(COMMAND_SEEK_TO_NEXT));
ชัตเตอร์เฟรมแรกและการแสดงรูปภาพ
เมื่อคอมโพเนนต์ UI แสดงวิดีโอหรือรูปภาพ โดยทั่วไปแล้วจะใช้มุมมองชัตเตอร์ตัวยึดตำแหน่งจนกว่าเฟรมแรกหรือรูปภาพจริงจะพร้อมใช้งาน นอกจากนี้ การเล่นวิดีโอและรูปภาพแบบผสมยังต้องซ่อนและแสดงมุมมองรูปภาพในเวลาที่เหมาะสม
รูปแบบทั่วไปในการจัดการข้อมูลอัปเดตเหล่านี้คือการฟัง
Player.Listener.onEvents() เพื่อดูการเปลี่ยนแปลงแทร็กที่เลือก
(EVENT_TRACKS_CHANGED) และเมื่อมีการแสดงเฟรมแรกของวิดีโอ
(EVENT_RENDERED_FIRST_FRAME) รวมถึง ImageOutput.onImageAvailable()
เมื่อมีรูปภาพใหม่พร้อมใช้งาน:
Kotlin
override fun onEvents(player: Player, events: Player.Events) { if (events.contains(Player.EVENT_TRACKS_CHANGED)) { // If no video or image track: show shutter, hide image view. // Otherwise: do nothing to wait for first frame or image. } if (events.contains(Player.EVENT_RENDERED_FIRST_FRAME)) { // Hide shutter, hide image view. } } override fun onImageAvailable(presentationTimeUs: Long, bitmap: Bitmap) { // Show shutter, set image and show image view. }
Java
@Override public void onEvents(Player player, Player.Events events) { if (events.contains(Player.EVENT_TRACKS_CHANGED)) { // If no video or image track: show shutter, hide image view. // Otherwise: do nothing to wait for first frame or image. } if (events.contains(Player.EVENT_RENDERED_FIRST_FRAME)) { // Hide shutter, hide image view. } } @Override public void onImageAvailable(long presentationTimeUs, Bitmap bitmap) { // Show shutter, set image and show image view. }