วิดีโอตัวอย่างเป็นวิธีที่ยอดเยี่ยมในการกระตุ้นให้ผู้ใช้ทำ Deep Link ไปยังแอป TV ของคุณ ตัวอย่างอาจมีตั้งแต่คลิปสั้นๆ ไปจนถึงตัวอย่างภาพยนตร์แบบเต็ม
โปรดคำนึงถึงหลักเกณฑ์ต่อไปนี้เมื่อสร้างตัวอย่าง
- อย่าแสดงโฆษณาในตัวอย่าง หากคุณต่อโฆษณาทางฝั่งไคลเอ็นต์ อย่าต่อโฆษณาเหล่านั้นเข้ากับวิดีโอตัวอย่าง หากคุณต่อโฆษณาในฝั่งเซิร์ฟเวอร์ ให้แสดงวิดีโอแบบไม่มีโฆษณาสำหรับตัวอย่างเนื้อหา
- วิดีโอตัวอย่างควรมีสัดส่วนภาพ 16:9 หรือ 4:3 เพื่อให้ได้คุณภาพดีที่สุด ดูขนาดวิดีโอตัวอย่างที่แนะนำได้ที่แอตทริบิวต์ของรายการวิดีโอ
- เมื่อวิดีโอตัวอย่างและภาพโปสเตอร์มีสัดส่วนภาพต่างกัน หน้าจอหลักจะปรับขนาดมุมมองโปสเตอร์ให้เป็นสัดส่วนภาพของวิดีโอก่อนเล่นตัวอย่าง วิดีโอไม่ได้อยู่ในรูปแบบ Letterbox เช่น หากสัดส่วนภาพโปสเตอร์คือ
ASPECT_RATIO_MOVIE_POSTER(1:1.441) แต่สัดส่วนวิดีโอคือ 16:9 มุมมองโปสเตอร์จะเปลี่ยนเป็นพื้นที่ 16:9 - เมื่อสร้างตัวอย่าง เนื้อหาของตัวอย่างจะเข้าถึงได้แบบสาธารณะหรือได้รับการคุ้มครองภายใต้ DRM โดยแต่ละกรณีจะมีขั้นตอนที่แตกต่างกัน หน้านี้จะอธิบายทั้ง 2 วิธี
เล่นตัวอย่างในหน้าจอหลัก
หากคุณสร้างตัวอย่างโดยใช้ประเภทวิดีโอที่ ExoPlayer รองรับและตัวอย่างดังกล่าวเข้าถึงได้แบบสาธารณะ คุณจะเล่นตัวอย่างได้โดยตรงบนหน้าจอหลัก
เมื่อสร้าง PreviewProgram ให้ใช้ setPreviewVideoUri() กับ HTTPS URL ที่เข้าถึงได้แบบสาธารณะดังที่แสดงในตัวอย่างต่อไปนี้ ตัวอย่างอาจเป็นวิดีโอหรือเสียงก็ได้
val previewVideoUrl = Uri.parse("https://www.example.com/preview.mp4") val builder = PreviewProgram.Builder() builder.setChannelId(channelId) // ... .setPreviewVideoUri(previewVideoUrl)
แสดงตัวอย่างบนแพลตฟอร์ม
หากวิดีโอมีการป้องกัน DRM หรืออยู่ในประเภทสื่อที่ ExoPlayer ไม่รองรับ ให้ใช้ TvInputService หน้าจอหลักของ Android TV จะส่ง Surface ไปยังบริการของคุณโดยเรียกใช้ onSetSurface() แอปของคุณวาดวิดีโอโดยตรงบนพื้นผิวนี้จาก onTune()
การแสดงผลบนพื้นผิวโดยตรงช่วยให้แอปควบคุมสิ่งที่แสดงผลและวิธีแสดงผลได้ คุณวางซ้อนข้อมูลเมตา เช่น การระบุแหล่งที่มาของช่องได้
ประกาศ TvInputService ในไฟล์ Manifest
แอปของคุณต้องมีการติดตั้งใช้งาน TvInputService เพื่อให้หน้าจอหลักแสดงตัวอย่างได้
ในการประกาศบริการ ให้ใส่ตัวกรอง Intent ที่ระบุ TvInputService เป็นการดำเนินการที่จะทำกับ Intent นอกจากนี้ ให้ประกาศข้อมูลเมตาของบริการเป็นทรัพยากร XML แยกต่างหากด้วย การประกาศบริการ ตัวกรอง Intent และการประกาศข้อมูลเมตาของบริการจะแสดงในตัวอย่างต่อไปนี้
<service android:name=".rich.PreviewInputService" android:permission="android.permission.BIND_TV_INPUT"> <!-- Required filter used by the system to launch our account service. --> <intent-filter> <action android:name="android.media.tv.TvInputService" /> </intent-filter> <!-- An XML file which describes this input. --> <meta-data android:name="android.media.tv.input" android:resource="@xml/previewinputservice" /> </service>
กำหนดข้อมูลเมตาของบริการในไฟล์ XML แยกต่างหาก
ไฟล์ข้อมูลเมตาของบริการจะอยู่ในไดเรกทอรีทรัพยากร XML สำหรับแอปของคุณ และต้องตรงกับชื่อทรัพยากรที่คุณประกาศไว้ในไฟล์ Manifest เมื่อใช้รายการไฟล์ Manifest จากตัวอย่างก่อนหน้านี้ คุณจะสร้างไฟล์ XML ที่ res/xml/previewinputservice.xml โดยมีแท็ก tv-input ที่ว่างเปล่า ดังนี้
<tv-input/>
เฟรมเวิร์กอินพุตทีวีต้องมีแท็กนี้ อย่างไรก็ตาม ฟีเจอร์นี้ใช้สำหรับกำหนดค่าช่องรายการสดเท่านั้น เนื่องจากคุณกำลังแสดงผลวิดีโอ แท็กจึงควรว่างเปล่า
สร้าง URI ของวิดีโอ
หากต้องการระบุว่าแอปควรแสดงผลวิดีโอตัวอย่างแทนหน้าจอหลักของ Android TV คุณต้องสร้าง URI ของวิดีโอสำหรับ PreviewProgram
URI ควรลงท้ายด้วยตัวระบุที่แอปใช้สำหรับเนื้อหา เพื่อให้คุณดึงเนื้อหาในภายหลังได้ใน TvInputService
หากตัวระบุเป็นประเภท Long ให้ใช้ TvContractCompat.buildPreviewProgramUri() ดังนี้
val id: Long = 1L // content identifier. val componentName = ComponentName(context, PreviewVideoInputService::class.java) val previewProgramVideoUri = TvContractCompat.buildPreviewProgramUri(id) .buildUpon() .appendQueryParameter("input", TvContractCompat.buildInputId(componentName)) .build()
หากตัวระบุไม่ใช่ประเภท Long ให้สร้าง URI โดยใช้ Uri.withAppendedPath() ดังนี้
val previewProgramVideoUri = Uri.withAppendedPath(PreviewPrograms.CONTENT_URI, "content-identifier") .buildUpon() .appendQueryParameter("input", TvContractCompat.buildInputId(componentName)) .build()
แอปของคุณจะเรียกใช้
onTune(Uri videoUri)
เพื่อให้ Android TV เริ่มแสดงตัวอย่างวิดีโอ
สร้างบริการ
ตัวอย่างต่อไปนี้แสดงวิธีขยาย TvInputService เพื่อสร้าง PreviewInputService ของคุณเอง โปรดทราบว่าบริการนี้ใช้ MediaPlayer สำหรับการเล่น
แต่โค้ดของคุณสามารถใช้วิดีโอเพลเยอร์ใดก็ได้ที่พร้อมใช้งาน
// import android.content.Context // import android.media.MediaPlayer // import android.media.tv.TvInputService // import android.net.Uri // import android.util.Log // import android.view.Surface // import java.io.IOException class PreviewVideoInputService : TvInputService() { override fun onCreateSession(inputId: String): TvInputService.Session? { return PreviewSession(this) } private inner class PreviewSession( internal var context: Context ) : TvInputService.Session(context) { internal var mediaPlayer: MediaPlayer? = MediaPlayer() override fun onRelease() { mediaPlayer?.release() mediaPlayer = null } override fun onTune(uri: Uri): Boolean { // Let the TvInputService know that the video is being loaded. notifyVideoUnavailable(VIDEO_UNAVAILABLE_REASON_TUNING) // Fetch the stream url from the TV Provider database // for content://android.media.tv/preview_program/<id>. val id = uri.lastPathSegment // Load your video in the background. retrieveYourVideoPreviewUrl(id) { videoUri -> if (videoUri == null) { Log.d(TAG, "Could not find video $id") notifyVideoUnavailable(TvInputManager.VIDEO_UNAVAILABLE_REASON_UNKNOWN) } try { mediaPlayer?.setDataSource(getApplicationContext(), videoUri) mediaPlayer?.prepare() mediaPlayer?.start() notifyVideoAvailable() } catch (e: IOException) { Log.e(TAG, "Could not prepare media player", e) notifyVideoUnavailable(TvInputManager.VIDEO_UNAVAILABLE_REASON_UNKNOWN) } } return true } override fun onSetSurface(surface: Surface?): Boolean { mediaPlayer?.setSurface(surface) return true } override fun onSetStreamVolume(volume: Float) { // The home screen may fade in and out the video's volume. // Your player should be updated accordingly. mediaPlayer?.setVolume(volume, volume) } override fun onSetCaptionEnabled(b: Boolean) { // enable/disable captions here. } } companion object { private const val TAG = "PreviewInputService" } }