Trang này chứa đoạn mã và nội dung mô tả về các tính năng có sẵn cho tuỳ chỉnh ứng dụng Bộ thu Android TV.
Định cấu hình thư viện
Cách cung cấp API Cast Connect cho ứng dụng Android TV:
-
Mở tệp
build.gradle
bên trong thư mục mô-đun ứng dụng của bạn. -
Xác minh rằng
google()
có trongrepositories
được liệt kê.repositories { google() }
-
Tuỳ thuộc vào loại thiết bị mục tiêu cho ứng dụng, hãy thêm các phiên bản mới nhất
của thư viện vào các phần phụ thuộc của bạn:
-
Đối với ứng dụng Android receiver:
dependencies { implementation 'com.google.android.gms:play-services-cast-tv:21.1.0' implementation 'com.google.android.gms:play-services-cast:21.5.0' }
-
Đối với ứng dụng Android Sender:
dependencies { implementation 'com.google.android.gms:play-services-cast:21.1.0' implementation 'com.google.android.gms:play-services-cast-framework:21.5.0' }
-
Đối với ứng dụng Android receiver:
-
Lưu các thay đổi rồi nhấp vào
Sync Project with Gradle Files
trên thanh công cụ.
-
Đảm bảo bạn
Podfile
đang nhắm mục tiêugoogle-cast-sdk
4.8.3 hoặc cao hơn -
Nhắm đến iOS 14 trở lên. Xem Ghi chú phát hành
để biết thêm chi tiết.
platform: ios, '14' def target_pods pod 'google-cast-sdk', '~>4.8.3' end
- Cần có trình duyệt Chromium phiên bản M87 trở lên.
-
Thêm thư viện Web Sender API vào dự án của bạn
<script src="//www.gstatic.com/cv/js/sender/v1/cast_sender.js?loadCastFramework=1"></script>
Yêu cầu AndroidX
Để sử dụng phiên bản mới của Dịch vụ Google Play, bạn phải cập nhật ứng dụng
không gian tên androidx
. Làm theo hướng dẫn dành cho
di chuyển sang AndroidX.
Ứng dụng Android TV – điều kiện tiên quyết
Để hỗ trợ Cast Connect trong ứng dụng Android TV của mình, bạn phải tạo và các sự kiện hỗ trợ từ một phiên đa phương tiện. Dữ liệu do phiên phát nội dung nghe nhìn của bạn cung cấp cung cấp các thông tin cơ bản (ví dụ: vị trí, trạng thái phát, v.v.) cho trạng thái nội dung nghe nhìn của bạn. Thư viện Cast Connect cũng sử dụng phiên phát nội dung đa phương tiện của bạn để báo hiệu khi nhận được một số tin nhắn từ người gửi, chẳng hạn như tạm dừng.
Để biết thêm thông tin về phiên phát nội dung nghe nhìn và cách khởi chạy một phiên phát nội dung nghe nhìn, xem hướng dẫn phiên đa phương tiện.
Vòng đời phiên nội dung nghe nhìn
Ứng dụng của bạn sẽ tạo một phiên nội dung nghe nhìn khi quá trình phát bắt đầu và nhả ra khi thiết bị không thể kiểm soát được nữa. Ví dụ: nếu ứng dụng của bạn là ứng dụng video, bạn sẽ huỷ bỏ phiên hoạt động khi người dùng thoát khỏi hoạt động phát (có thể bằng cách chọn "quay lại" để duyệt qua nội dung khác hoặc bằng cách chạy ứng dụng ở chế độ nền. Nếu ứng dụng là ứng dụng âm nhạc, bạn nên phát hành ứng dụng này khi ứng dụng của bạn không phát nữa nội dung đa phương tiện.
Đang cập nhật trạng thái phiên
Dữ liệu trong phiên đa phương tiện của bạn cần được cập nhật với trạng thái của trình phát. Ví dụ: khi chế độ phát bị tạm dừng, bạn nên cập nhật chế độ phát trạng thái cũng như các hành động được hỗ trợ. Các bảng sau đây liệt kê những trạng thái bạn có trách nhiệm cập nhật thông tin mới nhất.
MediaMetadataCompat
Trường siêu dữ liệu | Mô tả |
---|---|
METADATA_KEY_TITLE (bắt buộc) | Tiêu đề nội dung nghe nhìn. |
METADATA_KEY_DISPLAY_SUBTITLE | Phụ đề. |
METADATA_KEY_DISPLAY_ICON_URI | URL của biểu tượng. |
METADATA_KEY_DURATION (bắt buộc) | Thời lượng nội dung nghe nhìn. |
METADATA_KEY_MEDIA_URI | Content ID. |
METADATA_KEY_ARTIST | Nghệ sĩ. |
METADATA_KEY_ALBUM | Đĩa nhạc. |
PlaybackStateCompat
Phương thức bắt buộc | Mô tả |
---|---|
setActions() | Đặt các lệnh nội dung nghe nhìn được hỗ trợ. |
setState() | Đặt trạng thái phát và vị trí hiện tại. |
MediaSessionCompat
Phương thức bắt buộc | Mô tả |
---|---|
setRepeatMode() | Đặt chế độ lặp lại. |
setShuffleMode() | Đặt chế độ trộn bài. |
setMetadata() | Đặt siêu dữ liệu đa phương tiện. |
setPlaybackState() | Đặt trạng thái phát. |
private fun updateMediaSession() { val metadata = MediaMetadataCompat.Builder() .putString(MediaMetadataCompat.METADATA_KEY_TITLE, "title") .putString(MediaMetadataCompat.METADATA_KEY_DISPLAY_SUBTITLE, "subtitle") .putString(MediaMetadataCompat.METADATA_KEY_DISPLAY_ICON_URI, mMovie.getCardImageUrl()) .build() val playbackState = PlaybackStateCompat.Builder() .setState( PlaybackStateCompat.STATE_PLAYING, player.getPosition(), player.getPlaybackSpeed(), System.currentTimeMillis() ) .build() mediaSession.setMetadata(metadata) mediaSession.setPlaybackState(playbackState) }
private void updateMediaSession() { MediaMetadataCompat metadata = new MediaMetadataCompat.Builder() .putString(MediaMetadataCompat.METADATA_KEY_TITLE, "title") .putString(MediaMetadataCompat.METADATA_KEY_DISPLAY_SUBTITLE, "subtitle") .putString(MediaMetadataCompat.METADATA_KEY_DISPLAY_ICON_URI,mMovie.getCardImageUrl()) .build(); PlaybackStateCompat playbackState = new PlaybackStateCompat.Builder() .setState( PlaybackStateCompat.STATE_PLAYING, player.getPosition(), player.getPlaybackSpeed(), System.currentTimeMillis()) .build(); mediaSession.setMetadata(metadata); mediaSession.setPlaybackState(playbackState); }
Xử lý hoạt động kiểm soát phương tiện vận chuyển
Ứng dụng của bạn nên triển khai lệnh gọi lại kiểm soát truyền tải phiên đa phương tiện. Chiến lược phát hành đĩa đơn bảng sau đây cho biết những thao tác kiểm soát phương tiện vận chuyển mà họ cần xử lý:
MediaSessionCompat.Callback
Thao tác | Mô tả |
---|---|
onPlay() | Kích hoạt lại |
onPause() | Tạm dừng |
onSeekTo() | Tua đến một vị trí |
onStop() | Dừng nội dung nghe nhìn hiện tại |
class MyMediaSessionCallback : MediaSessionCompat.Callback() { override fun onPause() { // Pause the player and update the play state. ... } override fun onPlay() { // Resume the player and update the play state. ... } override fun onSeekTo (long pos) { // Seek and update the play state. ... } ... } mediaSession.setCallback( MyMediaSessionCallback() );
public MyMediaSessionCallback extends MediaSessionCompat.Callback { public void onPause() { // Pause the player and update the play state. ... } public void onPlay() { // Resume the player and update the play state. ... } public void onSeekTo (long pos) { // Seek and update the play state. ... } ... } mediaSession.setCallback(new MyMediaSessionCallback());
Định cấu hình chế độ hỗ trợ Cast
Khi một ứng dụng gửi yêu cầu khởi chạy gửi đi, một ý định sẽ được tạo
bằng không gian tên ứng dụng. Ứng dụng của bạn chịu trách nhiệm xử lý việc này
và tạo một phiên bản của
CastReceiverContext
khi khởi chạy ứng dụng TV. Cần có đối tượng CastReceiverContext
để tương tác với tính năng Truyền trong khi ứng dụng TV đang chạy. Đối tượng này cho phép TV của bạn
để chấp nhận tin nhắn đa phương tiện Truyền đến từ bất kỳ người gửi nào đã kết nối.
Thiết lập Android TV
Thêm bộ lọc ý định khởi chạy
Thêm một bộ lọc ý định mới vào hoạt động mà bạn muốn xử lý lần khởi chạy ý định từ ứng dụng của người gửi:
<activity android:name="com.example.activity">
<intent-filter>
<action android:name="com.google.android.gms.cast.tv.action.LAUNCH" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</activity>
Chỉ định nhà cung cấp tuỳ chọn receiver
Bạn cần triển khai một
ReceiverOptionsProvider
để cung cấp
CastReceiverOptions
:
class MyReceiverOptionsProvider : ReceiverOptionsProvider { override fun getOptions(context: Context?): CastReceiverOptions { return CastReceiverOptions.Builder(context) .setStatusText("My App") .build() } }
public class MyReceiverOptionsProvider implements ReceiverOptionsProvider { @Override public CastReceiverOptions getOptions(Context context) { return new CastReceiverOptions.Builder(context) .setStatusText("My App") .build(); } }
Sau đó, hãy chỉ định trình cung cấp tuỳ chọn trong AndroidManifest
:
<meta-data
android:name="com.google.android.gms.cast.tv.RECEIVER_OPTIONS_PROVIDER_CLASS_NAME"
android:value="com.example.mysimpleatvapplication.MyReceiverOptionsProvider" />
ReceiverOptionsProvider
được dùng để cung cấp CastReceiverOptions
khi
Đã khởi chạy CastReceiverContext
.
Ngữ cảnh của bộ nhận nội dung truyền
Khởi động
CastReceiverContext
khi tạo ứng dụng:
override fun onCreate() { CastReceiverContext.initInstance(this) ... }
@Override public void onCreate() { CastReceiverContext.initInstance(this); ... }
Khởi động CastReceiverContext
khi ứng dụng của bạn chuyển sang nền trước:
CastReceiverContext.getInstance().start()
CastReceiverContext.getInstance().start();
Gọi điện
stop()
trên
CastReceiverContext
sau khi ứng dụng chuyển sang chạy trong nền đối với các ứng dụng video hoặc ứng dụng không hỗ trợ
phát trong nền:
// Player has stopped. CastReceiverContext.getInstance().stop()
// Player has stopped. CastReceiverContext.getInstance().stop();
Ngoài ra, nếu ứng dụng của bạn không hỗ trợ tính năng phát trong nền, hãy gọi stop()
trên CastReceiverContext
khi ngừng phát trong nền.
Bạn nên dùng LifecycleObserver trên
androidx.lifecycle
để quản lý tính năng gọi điện
CastReceiverContext.start()
và
CastReceiverContext.stop()
,
đặc biệt nếu ứng dụng gốc của bạn có nhiều hoạt động. Cách này giúp tránh đua tranh
điều kiện khi bạn gọi start()
và stop()
từ các hoạt động khác nhau.
// Create a LifecycleObserver class. class MyLifecycleObserver : DefaultLifecycleObserver { override fun onStart(owner: LifecycleOwner) { // App prepares to enter foreground. CastReceiverContext.getInstance().start() } override fun onStop(owner: LifecycleOwner) { // App has moved to the background or has terminated. CastReceiverContext.getInstance().stop() } } // Add the observer when your application is being created. class MyApplication : Application() { fun onCreate() { super.onCreate() // Initialize CastReceiverContext. CastReceiverContext.initInstance(this /* android.content.Context */) // Register LifecycleObserver ProcessLifecycleOwner.get().lifecycle.addObserver( MyLifecycleObserver()) } }
// Create a LifecycleObserver class. public class MyLifecycleObserver implements DefaultLifecycleObserver { @Override public void onStart(LifecycleOwner owner) { // App prepares to enter foreground. CastReceiverContext.getInstance().start(); } @Override public void onStop(LifecycleOwner owner) { // App has moved to the background or has terminated. CastReceiverContext.getInstance().stop(); } } // Add the observer when your application is being created. public class MyApplication extends Application { @Override public void onCreate() { super.onCreate(); // Initialize CastReceiverContext. CastReceiverContext.initInstance(this /* android.content.Context */); // Register LifecycleObserver ProcessLifecycleOwner.get().getLifecycle().addObserver( new MyLifecycleObserver()); } }
// In AndroidManifest.xml set MyApplication as the application class
<application
...
android:name=".MyApplication">
Kết nối MediaSession với MediaManager
Khi bạn tạo một
MediaSession
!
bạn cũng cần cung cấp mã thông báo MediaSession
hiện tại cho
CastReceiverContext
để biết nơi gửi lệnh và truy xuất trạng thái phát nội dung đa phương tiện:
val mediaManager: MediaManager = receiverContext.getMediaManager() mediaManager.setSessionCompatToken(currentMediaSession.getSessionToken())
MediaManager mediaManager = receiverContext.getMediaManager(); mediaManager.setSessionCompatToken(currentMediaSession.getSessionToken());
Khi huỷ bỏ MediaSession
do không hoạt động, bạn nên đặt một
mã thông báo rỗng đang bật
MediaManager
:
myPlayer.stop() mediaSession.release() mediaManager.setSessionCompatToken(null)
myPlayer.stop(); mediaSession.release(); mediaManager.setSessionCompatToken(null);
Nếu ứng dụng của bạn hỗ trợ phát nội dung nghe nhìn khi ứng dụng đó chạy ở chế độ nền,
gọi điện
CastReceiverContext.stop()
khi ứng dụng được gửi xuống nền, bạn chỉ nên gọi khi ứng dụng của bạn
chạy trong nền và không còn phát nội dung nghe nhìn. Ví dụ:
class MyLifecycleObserver : DefaultLifecycleObserver { ... // App has moved to the background. override fun onPause(owner: LifecycleOwner) { mIsBackground = true myStopCastReceiverContextIfNeeded() } } // Stop playback on the player. private fun myStopPlayback() { myPlayer.stop() myStopCastReceiverContextIfNeeded() } // Stop the CastReceiverContext when both the player has // stopped and the app has moved to the background. private fun myStopCastReceiverContextIfNeeded() { if (mIsBackground && myPlayer.isStopped()) { CastReceiverContext.getInstance().stop() } }
public class MyLifecycleObserver implements DefaultLifecycleObserver { ... // App has moved to the background. @Override public void onPause(LifecycleOwner owner) { mIsBackground = true; myStopCastReceiverContextIfNeeded(); } } // Stop playback on the player. private void myStopPlayback() { myPlayer.stop(); myStopCastReceiverContextIfNeeded(); } // Stop the CastReceiverContext when both the player has // stopped and the app has moved to the background. private void myStopCastReceiverContextIfNeeded() { if (mIsBackground && myPlayer.isStopped()) { CastReceiverContext.getInstance().stop(); } }
Sử dụng Exoplayer với Cast Connect
Nếu bạn đang sử dụng
Exoplayer
, bạn có thể sử dụng
MediaSessionConnector
để tự động duy trì phiên họp và tất cả thông tin có liên quan, bao gồm
thay vì theo dõi các thay đổi theo cách thủ công.
MediaSessionConnector.MediaButtonEventHandler
có thể được dùng để xử lý các sự kiện MediaButton bằng cách gọi
setMediaButtonEventHandler(MediaButtonEventHandler)
vốn được xử lý bởi
MediaSessionCompat.Callback
theo mặc định.
Để tích hợp
MediaSessionConnector
trong ứng dụng của bạn, hãy thêm đoạn mã sau vào lớp hoạt động của người chơi hoặc vào bất cứ nơi nào bạn
quản lý phiên phát nội dung nghe nhìn:
class PlayerActivity : Activity() { private var mMediaSession: MediaSessionCompat? = null private var mMediaSessionConnector: MediaSessionConnector? = null private var mMediaManager: MediaManager? = null override fun onCreate(savedInstanceState: Bundle?) { ... mMediaSession = MediaSessionCompat(this, LOG_TAG) mMediaSessionConnector = MediaSessionConnector(mMediaSession!!) ... } override fun onStart() { ... mMediaManager = receiverContext.getMediaManager() mMediaManager!!.setSessionCompatToken(currentMediaSession.getSessionToken()) mMediaSessionConnector!!.setPlayer(mExoPlayer) mMediaSessionConnector!!.setMediaMetadataProvider(mMediaMetadataProvider) mMediaSession!!.isActive = true ... } override fun onStop() { ... mMediaSessionConnector!!.setPlayer(null) mMediaSession!!.release() mMediaManager!!.setSessionCompatToken(null) ... } }
public class PlayerActivity extends Activity { private MediaSessionCompat mMediaSession; private MediaSessionConnector mMediaSessionConnector; private MediaManager mMediaManager; @Override protected void onCreate(Bundle savedInstanceState) { ... mMediaSession = new MediaSessionCompat(this, LOG_TAG); mMediaSessionConnector = new MediaSessionConnector(mMediaSession); ... } @Override protected void onStart() { ... mMediaManager = receiverContext.getMediaManager(); mMediaManager.setSessionCompatToken(currentMediaSession.getSessionToken()); mMediaSessionConnector.setPlayer(mExoPlayer); mMediaSessionConnector.setMediaMetadataProvider(mMediaMetadataProvider); mMediaSession.setActive(true); ... } @Override protected void onStop() { ... mMediaSessionConnector.setPlayer(null); mMediaSession.release(); mMediaManager.setSessionCompatToken(null); ... } }
Thiết lập ứng dụng gửi
Bật tính năng hỗ trợ Cast Connect
Sau khi cập nhật ứng dụng gửi bằng tính năng hỗ trợ Cast Connect, bạn có thể khai báo
trạng thái sẵn sàng bằng cách đặt
androidReceiverCompatible
gắn cờ vào
LaunchOptions
thành true.
Cần có phiên bản play-services-cast-framework
19.0.0
trở lên.
Cờ androidReceiverCompatible
được đặt trong
LaunchOptions
(một phần của CastOptions
):
class CastOptionsProvider : OptionsProvider { override fun getCastOptions(context: Context?): CastOptions { val launchOptions: LaunchOptions = Builder() .setAndroidReceiverCompatible(true) .build() return CastOptions.Builder() .setLaunchOptions(launchOptions) ... .build() } }
public class CastOptionsProvider implements OptionsProvider { @Override public CastOptions getCastOptions(Context context) { LaunchOptions launchOptions = new LaunchOptions.Builder() .setAndroidReceiverCompatible(true) .build(); return new CastOptions.Builder() .setLaunchOptions(launchOptions) ... .build(); } }
Cần có google-cast-sdk
phiên bản v4.4.8
hoặc
cao hơn.
Cờ androidReceiverCompatible
được đặt trong
GCKLaunchOptions
(một phần của
GCKCastOptions
):
let options = GCKCastOptions(discoveryCriteria: GCKDiscoveryCriteria(applicationID: kReceiverAppID)) ... let launchOptions = GCKLaunchOptions() launchOptions.androidReceiverCompatible = true options.launchOptions = launchOptions GCKCastContext.setSharedInstanceWith(options)
Cần có phiên bản trình duyệt Chromium
M87
trở lên.
const context = cast.framework.CastContext.getInstance(); const castOptions = new cast.framework.CastOptions(); castOptions.receiverApplicationId = kReceiverAppID; castOptions.androidReceiverCompatible = true; context.setOptions(castOptions);
Thiết lập Cast Developer Console
Định cấu hình ứng dụng Android TV
Thêm tên gói của ứng dụng trên Android TV vào Cast Developer Console để liên kết ứng dụng đó với ID ứng dụng truyền của bạn.
Đăng ký thiết bị của nhà phát triển
Đăng ký số sê-ri của thiết bị Android TV mà bạn sẽ sử dụng để phát triển trong Cast Developer Console.
Nếu không đăng ký, Cast Connect sẽ chỉ hoạt động với các ứng dụng được cài đặt từ Cửa hàng Google Play vì lý do bảo mật.
Để biết thêm thông tin về cách đăng ký thiết bị Cast hoặc Android TV cho tính năng Truyền phát triển ứng dụng, hãy xem trang đăng ký.
Đang tải nội dung nghe nhìn
Nếu bạn đã triển khai tính năng hỗ trợ đường liên kết sâu trong ứng dụng Android TV, thì bạn cần định cấu hình định nghĩa tương tự trong Tệp kê khai Android TV:
<activity android:name="com.example.activity">
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<data android:scheme="https"/>
<data android:host="www.example.com"/>
<data android:pathPattern=".*"/>
</intent-filter>
</activity>
Tải theo thực thể trên người gửi
Đối với người gửi, bạn có thể chuyển đường liên kết sâu bằng cách đặt entity
trong nội dung nghe nhìn
cho yêu cầu tải đó:
val mediaToLoad = MediaInfo.Builder("some-id") .setEntity("https://example.com/watch/some-id") ... .build() val loadRequest = MediaLoadRequestData.Builder() .setMediaInfo(mediaToLoad) .setCredentials("user-credentials") ... .build() remoteMediaClient.load(loadRequest)
MediaInfo mediaToLoad = new MediaInfo.Builder("some-id") .setEntity("https://example.com/watch/some-id") ... .build(); MediaLoadRequestData loadRequest = new MediaLoadRequestData.Builder() .setMediaInfo(mediaToLoad) .setCredentials("user-credentials") ... .build(); remoteMediaClient.load(loadRequest);
let mediaInfoBuilder = GCKMediaInformationBuilder(entity: "https://example.com/watch/some-id") ... mediaInformation = mediaInfoBuilder.build() let mediaLoadRequestDataBuilder = GCKMediaLoadRequestDataBuilder() mediaLoadRequestDataBuilder.mediaInformation = mediaInformation mediaLoadRequestDataBuilder.credentials = "user-credentials" ... let mediaLoadRequestData = mediaLoadRequestDataBuilder.build() remoteMediaClient?.loadMedia(with: mediaLoadRequestData)
Cần có phiên bản trình duyệt Chromium
M87
trở lên.
let mediaInfo = new chrome.cast.media.MediaInfo('some-id"', 'video/mp4'); mediaInfo.entity = 'https://example.com/watch/some-id'; ... let request = new chrome.cast.media.LoadRequest(mediaInfo); request.credentials = 'user-credentials'; ... cast.framework.CastContext.getInstance().getCurrentSession().loadMedia(request);
Lệnh tải được gửi thông qua một ý định kèm theo đường liên kết sâu và tên gói mà bạn đã xác định trong bảng điều khiển dành cho nhà phát triển.
Đặt thông tin xác thực ATV trên người gửi
Có thể ứng dụng Trình nhận web và ứng dụng Android TV hỗ trợ các chế độ khác nhau
đường liên kết sâu và credentials
(ví dụ: nếu bạn đang xử lý quá trình xác thực
theo cách khác nhau ở hai nền tảng). Để giải quyết vấn đề này, bạn có thể cung cấp
entity
và credentials
cho Android TV:
val mediaToLoad = MediaInfo.Builder("some-id") .setEntity("https://example.com/watch/some-id") .setAtvEntity("myscheme://example.com/atv/some-id") ... .build() val loadRequest = MediaLoadRequestData.Builder() .setMediaInfo(mediaToLoad) .setCredentials("user-credentials") .setAtvCredentials("atv-user-credentials") ... .build() remoteMediaClient.load(loadRequest)
MediaInfo mediaToLoad = new MediaInfo.Builder("some-id") .setEntity("https://example.com/watch/some-id") .setAtvEntity("myscheme://example.com/atv/some-id") ... .build(); MediaLoadRequestData loadRequest = new MediaLoadRequestData.Builder() .setMediaInfo(mediaToLoad) .setCredentials("user-credentials") .setAtvCredentials("atv-user-credentials") ... .build(); remoteMediaClient.load(loadRequest);
let mediaInfoBuilder = GCKMediaInformationBuilder(entity: "https://example.com/watch/some-id") mediaInfoBuilder.atvEntity = "myscheme://example.com/atv/some-id" ... mediaInformation = mediaInfoBuilder.build() let mediaLoadRequestDataBuilder = GCKMediaLoadRequestDataBuilder() mediaLoadRequestDataBuilder.mediaInformation = mediaInformation mediaLoadRequestDataBuilder.credentials = "user-credentials" mediaLoadRequestDataBuilder.atvCredentials = "atv-user-credentials" ... let mediaLoadRequestData = mediaLoadRequestDataBuilder.build() remoteMediaClient?.loadMedia(with: mediaLoadRequestData)
Cần có phiên bản trình duyệt Chromium
M87
trở lên.
let mediaInfo = new chrome.cast.media.MediaInfo('some-id"', 'video/mp4'); mediaInfo.entity = 'https://example.com/watch/some-id'; mediaInfo.atvEntity = 'myscheme://example.com/atv/some-id'; ... let request = new chrome.cast.media.LoadRequest(mediaInfo); request.credentials = 'user-credentials'; request.atvCredentials = 'atv-user-credentials'; ... cast.framework.CastContext.getInstance().getCurrentSession().loadMedia(request);
Nếu bạn chạy ứng dụng Trình nhận web, ứng dụng này sẽ sử dụng entity
và credentials
trong
yêu cầu tải. Tuy nhiên, nếu bạn chạy ứng dụng Android TV, SDK sẽ ghi đè
entity
và credentials
cùng với atvEntity
và atvCredentials
của bạn
(nếu được chỉ định).
Tải bằng Content ID hoặc MediaQueueData
Nếu bạn hiện không dùng entity
hay atvEntity
và đang dùng Content ID hoặc
URL nội dung trong Thông tin phương tiện của bạn hoặc sử dụng Tải phương tiện chi tiết hơn
Yêu cầu dữ liệu, bạn cần thêm bộ lọc ý định định sẵn sau đây vào
ứng dụng Android TV của bạn:
<activity android:name="com.example.activity">
<intent-filter>
<action android:name="com.google.android.gms.cast.tv.action.LOAD"/>
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</activity>
Ở phía người gửi, tương tự như tải theo thực thể, bạn
có thể tạo một yêu cầu tải với thông tin nội dung của mình và gọi load()
.
val mediaToLoad = MediaInfo.Builder("some-id").build() val loadRequest = MediaLoadRequestData.Builder() .setMediaInfo(mediaToLoad) .setCredentials("user-credentials") ... .build() remoteMediaClient.load(loadRequest)
MediaInfo mediaToLoad = new MediaInfo.Builder("some-id").build(); MediaLoadRequestData loadRequest = new MediaLoadRequestData.Builder() .setMediaInfo(mediaToLoad) .setCredentials("user-credentials") ... .build(); remoteMediaClient.load(loadRequest);
let mediaInfoBuilder = GCKMediaInformationBuilder(contentId: "some-id") ... mediaInformation = mediaInfoBuilder.build() let mediaLoadRequestDataBuilder = GCKMediaLoadRequestDataBuilder() mediaLoadRequestDataBuilder.mediaInformation = mediaInformation mediaLoadRequestDataBuilder.credentials = "user-credentials" ... let mediaLoadRequestData = mediaLoadRequestDataBuilder.build() remoteMediaClient?.loadMedia(with: mediaLoadRequestData)
Cần có phiên bản trình duyệt Chromium
M87
trở lên.
let mediaInfo = new chrome.cast.media.MediaInfo('some-id"', 'video/mp4'); ... let request = new chrome.cast.media.LoadRequest(mediaInfo); ... cast.framework.CastContext.getInstance().getCurrentSession().loadMedia(request);
Xử lý các yêu cầu tải
Trong hoạt động, để xử lý các yêu cầu tải này, bạn cần xử lý các ý định trong các phương thức gọi lại trong vòng đời hoạt động:
class MyActivity : Activity() { override fun onStart() { super.onStart() val mediaManager = CastReceiverContext.getInstance().getMediaManager() // Pass the intent to the SDK. You can also do this in onCreate(). if (mediaManager.onNewIntent(intent)) { // If the SDK recognizes the intent, you should early return. return } // If the SDK doesn't recognize the intent, you can handle the intent with // your own logic. ... } // For some cases, a new load intent triggers onNewIntent() instead of // onStart(). override fun onNewIntent(intent: Intent) { val mediaManager = CastReceiverContext.getInstance().getMediaManager() // Pass the intent to the SDK. You can also do this in onCreate(). if (mediaManager.onNewIntent(intent)) { // If the SDK recognizes the intent, you should early return. return } // If the SDK doesn't recognize the intent, you can handle the intent with // your own logic. ... } }
public class MyActivity extends Activity { @Override protected void onStart() { super.onStart(); MediaManager mediaManager = CastReceiverContext.getInstance().getMediaManager(); // Pass the intent to the SDK. You can also do this in onCreate(). if (mediaManager.onNewIntent(getIntent())) { // If the SDK recognizes the intent, you should early return. return; } // If the SDK doesn't recognize the intent, you can handle the intent with // your own logic. ... } // For some cases, a new load intent triggers onNewIntent() instead of // onStart(). @Override protected void onNewIntent(Intent intent) { MediaManager mediaManager = CastReceiverContext.getInstance().getMediaManager(); // Pass the intent to the SDK. You can also do this in onCreate(). if (mediaManager.onNewIntent(intent)) { // If the SDK recognizes the intent, you should early return. return; } // If the SDK doesn't recognize the intent, you can handle the intent with // your own logic. ... } }
Nếu MediaManager
phát hiện thấy ý định là một ý định tải, nó sẽ trích xuất một
MediaLoadRequestData
đối tượng khỏi ý định và gọi
MediaLoadCommandCallback.onLoad()
.
Bạn cần phải ghi đè phương thức này để xử lý yêu cầu tải. Lệnh gọi lại phải
được đăng ký trước
MediaManager.onNewIntent()
được gọi (nên ở trên onCreate()
Hoạt động hoặc Ứng dụng
).
class MyActivity : Activity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) val mediaManager = CastReceiverContext.getInstance().getMediaManager() mediaManager.setMediaLoadCommandCallback(MyMediaLoadCommandCallback()) } } class MyMediaLoadCommandCallback : MediaLoadCommandCallback() { override fun onLoad( senderId: String?, loadRequestData: MediaLoadRequestData ): Task{ return Tasks.call { // Resolve the entity into your data structure and load media. val mediaInfo = loadRequestData.getMediaInfo() if (!checkMediaInfoSupported(mediaInfo)) { // Throw MediaException to indicate load failure. throw MediaException( MediaError.Builder() .setDetailedErrorCode(DetailedErrorCode.LOAD_FAILED) .setReason(MediaError.ERROR_REASON_INVALID_REQUEST) .build() ) } myFillMediaInfo(MediaInfoWriter(mediaInfo)) myPlayerLoad(mediaInfo.getContentUrl()) // Update media metadata and state (this clears all previous status // overrides). castReceiverContext.getMediaManager() .setDataFromLoad(loadRequestData) ... castReceiverContext.getMediaManager().broadcastMediaStatus() // Return the resolved MediaLoadRequestData to indicate load success. return loadRequestData } } private fun myPlayerLoad(contentURL: String) { myPlayer.load(contentURL) // Update the MediaSession state. val playbackState: PlaybackStateCompat = Builder() .setState( player.getState(), player.getPosition(), System.currentTimeMillis() ) ... .build() mediaSession.setPlaybackState(playbackState) }
public class MyActivity extends Activity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); MediaManager mediaManager = CastReceiverContext.getInstance().getMediaManager(); mediaManager.setMediaLoadCommandCallback(new MyMediaLoadCommandCallback()); } } public class MyMediaLoadCommandCallback extends MediaLoadCommandCallback { @Override public TaskonLoad(String senderId, MediaLoadRequestData loadRequestData) { return Tasks.call(() -> { // Resolve the entity into your data structure and load media. MediaInfo mediaInfo = loadRequestData.getMediaInfo(); if (!checkMediaInfoSupported(mediaInfo)) { // Throw MediaException to indicate load failure. throw new MediaException( new MediaError.Builder() .setDetailedErrorCode(DetailedErrorCode.LOAD_FAILED) .setReason(MediaError.ERROR_REASON_INVALID_REQUEST) .build()); } myFillMediaInfo(new MediaInfoWriter(mediaInfo)); myPlayerLoad(mediaInfo.getContentUrl()); // Update media metadata and state (this clears all previous status // overrides). castReceiverContext.getMediaManager() .setDataFromLoad(loadRequestData); ... castReceiverContext.getMediaManager().broadcastMediaStatus(); // Return the resolved MediaLoadRequestData to indicate load success. return loadRequestData; }); } private void myPlayerLoad(String contentURL) { myPlayer.load(contentURL); // Update the MediaSession state. PlaybackStateCompat playbackState = new PlaybackStateCompat.Builder() .setState( player.getState(), player.getPosition(), System.currentTimeMillis()) ... .build(); mediaSession.setPlaybackState(playbackState); }
Để xử lý ý định tải, bạn có thể phân tích cú pháp ý định thành cấu trúc dữ liệu
chúng ta đã xác định
(MediaLoadRequestData
cho các yêu cầu tải).
Hỗ trợ các lệnh đa phương tiện
Hỗ trợ cơ bản về bộ điều khiển chế độ phát
Lệnh tích hợp cơ bản bao gồm những lệnh tương thích với nội dung nghe nhìn phiên hoạt động. Các lệnh này được thông báo qua lệnh gọi lại phiên phát nội dung nghe nhìn. Bạn cần đăng ký lệnh gọi lại đến phiên phát nội dung đa phương tiện để hỗ trợ việc này (bạn có thể làm việc này rồi).
private class MyMediaSessionCallback : MediaSessionCompat.Callback() { override fun onPause() { // Pause the player and update the play state. myPlayer.pause() } override fun onPlay() { // Resume the player and update the play state. myPlayer.play() } override fun onSeekTo(pos: Long) { // Seek and update the play state. myPlayer.seekTo(pos) } ... } mediaSession.setCallback(MyMediaSessionCallback())
private class MyMediaSessionCallback extends MediaSessionCompat.Callback { @Override public void onPause() { // Pause the player and update the play state. myPlayer.pause(); } @Override public void onPlay() { // Resume the player and update the play state. myPlayer.play(); } @Override public void onSeekTo(long pos) { // Seek and update the play state. myPlayer.seekTo(pos); } ... } mediaSession.setCallback(new MyMediaSessionCallback());
Hỗ trợ các lệnh điều khiển nội dung Truyền
Có một số lệnh Truyền không dùng được trong
MediaSession
!
chẳng hạn như
skipAd()
hoặc
setActiveMediaTracks()
.
Ngoài ra, một số lệnh hàng đợi cần được triển khai tại đây vì hàng đợi Truyền
không hoàn toàn tương thích với hàng đợi MediaSession
.
class MyMediaCommandCallback : MediaCommandCallback() { override fun onSkipAd(requestData: RequestData?): Task{ // Skip your ad ... return Tasks.forResult(null) } } val mediaManager = CastReceiverContext.getInstance().getMediaManager() mediaManager.setMediaCommandCallback(MyMediaCommandCallback())
public class MyMediaCommandCallback extends MediaCommandCallback { @Override public TaskonSkipAd(RequestData requestData) { // Skip your ad ... return Tasks.forResult(null); } } MediaManager mediaManager = CastReceiverContext.getInstance().getMediaManager(); mediaManager.setMediaCommandCallback(new MyMediaCommandCallback());
Chỉ định các lệnh đa phương tiện được hỗ trợ
Tương tự như với bộ thu Truyền, ứng dụng Android TV phải chỉ định lệnh nào
được hỗ trợ để người gửi có thể bật hoặc tắt một số chế độ điều khiển trên giao diện người dùng. Cho
các lệnh thuộc
MediaSession
!
chỉ định các lệnh trong
PlaybackStateCompat
.
Các lệnh bổ sung nên được chỉ định trong
MediaStatusModifier
.
// Set media session supported commands val playbackState: PlaybackStateCompat = PlaybackStateCompat.Builder() .setActions(PlaybackStateCompat.ACTION_PLAY or PlaybackStateCompat.ACTION_PAUSE) .setState(PlaybackStateCompat.STATE_PLAYING) .build() mediaSession.setPlaybackState(playbackState) // Set additional commands in MediaStatusModifier val mediaManager = CastReceiverContext.getInstance().getMediaManager() mediaManager.getMediaStatusModifier() .setMediaCommandSupported(MediaStatus.COMMAND_QUEUE_NEXT)
// Set media session supported commands PlaybackStateCompat playbackState = new PlaybackStateCompat.Builder() .setActions(PlaybackStateCompat.ACTION_PLAY | PlaybackStateCompat.ACTION_PAUSE) .setState(PlaybackStateCompat.STATE_PLAYING) .build(); mediaSession.setPlaybackState(playbackState); // Set additional commands in MediaStatusModifier MediaManager mediaManager = CastReceiverContext.getInstance().getMediaManager(); mediaManager.getMediaStatusModifier() .setMediaCommandSupported(MediaStatus.COMMAND_QUEUE_NEXT);
Ẩn các nút không được hỗ trợ
Nếu ứng dụng Android TV chỉ hỗ trợ tính năng điều khiển nội dung nghe nhìn cơ bản nhưng hỗ trợ Bộ thu trên web ứng dụng hỗ trợ kiểm soát nâng cao hơn, bạn nên đảm bảo rằng ứng dụng của người gửi hoạt động đúng cách khi truyền tới ứng dụng Android TV. Ví dụ: nếu Android TV của bạn ứng dụng không hỗ trợ thay đổi tốc độ phát lại trong khi ứng dụng Trình nhận web có hỗ trợ, bạn nên thiết lập chính xác các thao tác được hỗ trợ trên từng nền tảng và đảm bảo ứng dụng của người gửi hiển thị giao diện người dùng chính xác.
Sửa đổi MediaStatus
Để hỗ trợ các tính năng nâng cao như theo dõi, quảng cáo, phát trực tiếp và thêm vào danh sách chờ, thiết bị Android
Ứng dụng truyền hình cần cung cấp thêm thông tin không thể xác định được thông qua
MediaSession
.
Chúng tôi cung cấp
MediaStatusModifier
dành cho bạn để đạt được mục tiêu này. MediaStatusModifier
sẽ luôn hoạt động trên
MediaSession
mà bạn đã đặt
CastReceiverContext
.
Để tạo và truyền tin
MediaStatus
:
val mediaManager: MediaManager = castReceiverContext.getMediaManager() val statusModifier: MediaStatusModifier = mediaManager.getMediaStatusModifier() statusModifier .setLiveSeekableRange(seekableRange) .setAdBreakStatus(adBreakStatus) .setCustomData(customData) mediaManager.broadcastMediaStatus()
MediaManager mediaManager = castReceiverContext.getMediaManager(); MediaStatusModifier statusModifier = mediaManager.getMediaStatusModifier(); statusModifier .setLiveSeekableRange(seekableRange) .setAdBreakStatus(adBreakStatus) .setCustomData(customData); mediaManager.broadcastMediaStatus();
Thư viện ứng dụng của chúng tôi sẽ nhận MediaStatus
cơ sở từ MediaSession
,
Ứng dụng Android TV có thể chỉ định trạng thái bổ sung và ghi đè trạng thái thông qua
Đối tượng sửa đổi MediaStatus
.
Một số trạng thái và siêu dữ liệu có thể đặt cả trong MediaSession
và
MediaStatusModifier
Bạn rất nên chỉ đặt chúng trong
MediaSession
. Bạn vẫn có thể sử dụng đối tượng sửa đổi để ghi đè các trạng thái trong
MediaSession
– bạn không nên làm việc này vì trạng thái trong đối tượng sửa đổi luôn luôn
có mức độ ưu tiên cao hơn giá trị do MediaSession
cung cấp.
Chặn MediaStatus trước khi gửi đi
Giống như SDK Web receiver, nếu bạn muốn thực hiện một số bước hoàn thiện trước
đang gửi đi, bạn có thể chỉ định
MediaStatusInterceptor
để xử lý
MediaStatus
đến
gửi. Chúng ta truyền vào một
MediaStatusWriter
để thao tác MediaStatus
trước khi gửi đi.
mediaManager.setMediaStatusInterceptor(object : MediaStatusInterceptor { override fun intercept(mediaStatusWriter: MediaStatusWriter) { // Perform customization. mediaStatusWriter.setCustomData(JSONObject("{data: \"my Hello\"}")) } })
mediaManager.setMediaStatusInterceptor(new MediaStatusInterceptor() { @Override public void intercept(MediaStatusWriter mediaStatusWriter) { // Perform customization. mediaStatusWriter.setCustomData(new JSONObject("{data: \"my Hello\"}")); } });
Xử lý thông tin đăng nhập của người dùng
Ứng dụng Android TV của bạn có thể chỉ cho phép một số người dùng chạy hoặc tham gia ứng dụng phiên hoạt động. Ví dụ: chỉ cho phép người gửi khởi chạy hoặc tham gia nếu:
- Ứng dụng của người gửi được đăng nhập vào cùng một tài khoản và hồ sơ với ứng dụng ATV.
- Ứng dụng của người gửi được đăng nhập vào cùng một tài khoản, nhưng hồ sơ khác với ứng dụng ATV.
Nếu ứng dụng của bạn có thể xử lý nhiều người dùng hoặc người dùng ẩn danh, bạn có thể cho phép thêm bất kỳ người dùng nào người dùng để tham gia phiên ATV. Nếu người dùng cung cấp thông tin đăng nhập, ứng dụng ATV của bạn cần xử lý thông tin đăng nhập của họ để tiến trình và dữ liệu người dùng khác có thể được theo dõi đúng cách.
Khi ứng dụng của người gửi khởi chạy hoặc tham gia ứng dụng Android TV của bạn, ứng dụng của người gửi phải cung cấp thông tin đăng nhập đại diện cho ai sẽ tham gia phiên.
Trước khi người gửi khởi chạy và tham gia ứng dụng Android TV, bạn có thể chỉ định Khởi chạy trình kiểm tra để xem liệu thông tin xác thực của người gửi có được cho phép không. Nếu không, Cast Connect SDK quay lại khởi chạy Web receiver.
Dữ liệu thông tin xác thực chạy ứng dụng dành cho người gửi
Ở phía người gửi, bạn có thể chỉ định CredentialsData
để đại diện cho
tham gia phiên đào tạo này.
credentials
là một chuỗi mà người dùng có thể xác định, miễn là ATV của bạn
ứng dụng có thể hiểu được thông tin đó. credentialsType
xác định nền tảng
CredentialsData
đến từ hoặc có thể là giá trị tuỳ chỉnh. Theo mặc định, giá trị này được đặt
vào nền tảng gửi thư.
CredentialsData
chỉ được truyền đến ứng dụng Android TV của bạn trong quá trình khởi chạy hoặc
thời gian tham gia. Nếu bạn thiết lập lại trong khi đã kết nối, mật khẩu sẽ không được chuyển đến
ứng dụng Android TV của bạn. Nếu người gửi chuyển đổi hồ sơ trong khi kết nối, bạn
có thể ở lại phiên hoặc gọi
SessionManager.endCurrentCastSession(boolean stopCasting)
nếu bạn cho rằng hồ sơ mới không tương thích với phiên hoạt động.
Chiến lược phát hành đĩa đơn
CredentialsData
cho mỗi người gửi có thể được truy xuất bằng cách sử dụng
getSenders
trên
CastReceiverContext
để nhận SenderInfo
,
getCastLaunchRequest()
để tải
CastLaunchRequest
,
sau đó
getCredentialsData()
.
Cần có phiên bản play-services-cast-framework
19.0.0
trở lên.
CastContext.getSharedInstance().setLaunchCredentialsData( CredentialsData.Builder() .setCredentials("{\"userId\": \"abc\"}") .build() )
CastContext.getSharedInstance().setLaunchCredentialsData( new CredentialsData.Builder() .setCredentials("{\"userId\": \"abc\"}") .build());
Cần có google-cast-sdk
phiên bản v4.8.3
hoặc
cao hơn.
Có thể gọi bất cứ lúc nào sau khi bạn đặt các tuỳ chọn:
GCKCastContext.setSharedInstanceWith(options)
.
GCKCastContext.sharedInstance().setLaunch( GCKCredentialsData(credentials: "{\"userId\": \"abc\"}")
Cần có phiên bản trình duyệt Chromium
M87
trở lên.
Có thể gọi bất cứ lúc nào sau khi bạn đặt các tuỳ chọn:
cast.framework.CastContext.getInstance().setOptions(options);
.
let credentialsData = new chrome.cast.CredentialsData("{\"userId\": \"abc\"}"); cast.framework.CastContext.getInstance().setLaunchCredentialsData(credentialsData);
Triển khai trình kiểm tra yêu cầu khởi chạy ATV
Chiến lược phát hành đĩa đơn
CredentialsData
được chuyển đến ứng dụng Android TV của bạn khi người gửi cố gắng khởi chạy hoặc tham gia. Bạn có thể
hãy triển khai một
LaunchRequestChecker
.
để cho phép hoặc từ chối yêu cầu này.
Nếu yêu cầu bị từ chối, Trình nhận trên web sẽ được tải thay vì khởi chạy ngay trong ứng dụng ATV. Bạn nên từ chối yêu cầu nếu ATV của bạn không thể xử lý yêu cầu khởi chạy hoặc tham gia của người dùng. Ví dụ: một Người dùng đăng nhập vào ứng dụng ATV so với yêu cầu và ứng dụng của bạn không thể xử lý thông tin xác thực chuyển đổi hoặc hiện không có người dùng nào đăng nhập vào ứng dụng ATV.
Nếu cho phép một yêu cầu, ứng dụng ATV sẽ khởi chạy. Bạn có thể tuỳ chỉnh chế độ này
tùy thuộc vào việc ứng dụng của bạn có hỗ trợ gửi yêu cầu tải khi người dùng
chưa đăng nhập vào ứng dụng ATV hoặc nếu có người dùng không khớp. Hành vi này
có thể sử dụng hoàn toàn trong LaunchRequestChecker
.
Tạo một lớp triển khai
CastReceiverOptions.LaunchRequestChecker
giao diện:
class MyLaunchRequestChecker : LaunchRequestChecker { override fun checkLaunchRequestSupported(launchRequest: CastLaunchRequest): Task{ return Tasks.call { myCheckLaunchRequest( launchRequest ) } } } private fun myCheckLaunchRequest(launchRequest: CastLaunchRequest): Boolean { val credentialsData = launchRequest.getCredentialsData() ?: return false // or true if you allow anonymous users to join. // The request comes from a mobile device, e.g. checking user match. return if (credentialsData.credentialsType == CredentialsData.CREDENTIALS_TYPE_ANDROID) { myCheckMobileCredentialsAllowed(credentialsData.getCredentials()) } else false // Unrecognized credentials type. }
public class MyLaunchRequestChecker implements CastReceiverOptions.LaunchRequestChecker { @Override public TaskcheckLaunchRequestSupported(CastLaunchRequest launchRequest) { return Tasks.call(() -> myCheckLaunchRequest(launchRequest)); } } private boolean myCheckLaunchRequest(CastLaunchRequest launchRequest) { CredentialsData credentialsData = launchRequest.getCredentialsData(); if (credentialsData == null) { return false; // or true if you allow anonymous users to join. } // The request comes from a mobile device, e.g. checking user match. if (credentialsData.getCredentialsType().equals(CredentialsData.CREDENTIALS_TYPE_ANDROID)) { return myCheckMobileCredentialsAllowed(credentialsData.getCredentials()); } // Unrecognized credentials type. return false; }
Sau đó, đặt URL đó trong
ReceiverOptionsProvider
:
class MyReceiverOptionsProvider : ReceiverOptionsProvider { override fun getOptions(context: Context?): CastReceiverOptions { return CastReceiverOptions.Builder(context) ... .setLaunchRequestChecker(MyLaunchRequestChecker()) .build() } }
public class MyReceiverOptionsProvider implements ReceiverOptionsProvider { @Override public CastReceiverOptions getOptions(Context context) { return new CastReceiverOptions.Builder(context) ... .setLaunchRequestChecker(new MyLaunchRequestChecker()) .build(); } }
Giải quyết true
trong
LaunchRequestChecker
chạy ứng dụng ATV và false
chạy ứng dụng Web receiver.
Gửi & Nhận thông báo tuỳ chỉnh
Giao thức Cast cho phép bạn gửi thông báo chuỗi tuỳ chỉnh giữa người gửi và
ứng dụng nhận của bạn. Bạn phải đăng ký không gian tên (kênh) để gửi
trước khi khởi tạo
CastReceiverContext
.
Android TV – Chỉ định không gian tên tuỳ chỉnh
Bạn cần chỉ định không gian tên được hỗ trợ trong
CastReceiverOptions
trong khi thiết lập:
class MyReceiverOptionsProvider : ReceiverOptionsProvider { override fun getOptions(context: Context?): CastReceiverOptions { return CastReceiverOptions.Builder(context) .setCustomNamespaces( Arrays.asList("urn:x-cast:com.example.cast.mynamespace") ) .build() } }
public class MyReceiverOptionsProvider implements ReceiverOptionsProvider { @Override public CastReceiverOptions getOptions(Context context) { return new CastReceiverOptions.Builder(context) .setCustomNamespaces( Arrays.asList("urn:x-cast:com.example.cast.mynamespace")) .build(); } }
Android TV – Gửi tin nhắn
// If senderId is null, then the message is broadcasted to all senders. CastReceiverContext.getInstance().sendMessage( "urn:x-cast:com.example.cast.mynamespace", senderId, customString)
// If senderId is null, then the message is broadcasted to all senders. CastReceiverContext.getInstance().sendMessage( "urn:x-cast:com.example.cast.mynamespace", senderId, customString);
Android TV – Nhận thông báo không gian tên tuỳ chỉnh
class MyCustomMessageListener : MessageReceivedListener { override fun onMessageReceived( namespace: String, senderId: String?, message: String ) { ... } } CastReceiverContext.getInstance().setMessageReceivedListener( "urn:x-cast:com.example.cast.mynamespace", new MyCustomMessageListener());
class MyCustomMessageListener implements CastReceiverContext.MessageReceivedListener { @Override public void onMessageReceived( String namespace, String senderId, String message) { ... } } CastReceiverContext.getInstance().setMessageReceivedListener( "urn:x-cast:com.example.cast.mynamespace", new MyCustomMessageListener());