अपने Android ऐप्लिकेशन में बेहतर सुविधाएं जोड़ना

विज्ञापन के लिए ब्रेक

Android Sender SDK, किसी मीडिया स्ट्रीम में विज्ञापन के लिए ब्रेक और साथ में दिखने वाले विज्ञापनों की सुविधा देता है.

विज्ञापन के लिए ब्रेक की सुविधा कैसे काम करती है, इस बारे में ज़्यादा जानने के लिए, Web Receiver में विज्ञापन के लिए ब्रेक की खास जानकारी देखें.

सेंडर और रिसीवर, दोनों पर ब्रेक तय किए जा सकते हैं. हालांकि, हमारा सुझाव है कि इन्हें Web Receiver और Android TV Receiver पर तय किया जाए, ताकि सभी प्लैटफ़ॉर्म पर एक जैसा अनुभव मिले.

Android पर, लोड करने के निर्देश में विज्ञापन के लिए ब्रेक तय करने के लिए, AdBreakClipInfo और AdBreakInfoका इस्तेमाल करें:

Kotlin
val breakClip1: AdBreakClipInfo =
    AdBreakClipInfo.Builder("bc0")
        .setTitle("Clip title")
        .setPosterUrl("https://www.some.url")
        .setDuration(60000)
        .setWhenSkippableInMs(5000)  // Set this field so that the ad is skippable
        .build()

val breakClip2: AdBreakClipInfo = …
val breakClip3: AdBreakClipInfo = …

val break1: AdBreakClipInfo =
    AdBreakInfo.Builder(/* playbackPositionInMs= */ 10000)
        .setId("b0")
        .setBreakClipIds({"bc0","bc1","bc2"})
        …
        .build()

val mediaInfo: MediaInfo = MediaInfo.Builder()
    …
    .setAdBreaks({break1})
    .setAdBreakClips({breakClip1, breakClip2, breakClip3})
    .build()

val mediaLoadRequestData: MediaLoadRequestData = MediaInfo.Builder()
    …
    .setMediaInfo(mediaInfo)
    .build()

remoteMediaClient.load(mediaLoadRequestData)
Java
AdBreakClipInfo breakClip1 =
    new AdBreakClipInfo.Builder("bc0")
        .setTitle("Clip title")
        .setPosterUrl("https://www.some.url")
        .setDuration(60000)
        .setWhenSkippableInMs(5000)  // Set this field so that the ad is skippable
        .build();

AdBreakClipInfo breakClip2 = …
AdBreakClipInfo breakClip3 = …

AdBreakInfo break1 =
    new AdBreakInfo.Builder(/* playbackPositionInMs= */ 10000)
        .setId("b0")
        .setBreakClipIds({"bc0","bc1","bc2"})
        …
        .build();

MediaInfo mediaInfo = new MediaInfo.Builder()
    …
    .setAdBreaks({break1})
    .setAdBreakClips({breakClip1, breakClip2, breakClip3})
    .build();

MediaLoadRequestData mediaLoadRequestData = new MediaInfo.Builder()
    …
    .setMediaInfo(mediaInfo)
    .build();

remoteMediaClient.load(mediaLoadRequestData);

कस्टम कार्रवाइयां जोड़ना

सेंडर ऐप्लिकेशन, कस्टम कार्रवाइयों को मैनेज करने या उसके व्यवहार को बदलने के लिए, MediaIntentReceiver को बढ़ाया जा सकता है. अगर आपने अपना MediaIntentReceiver लागू किया है, तो आपको इसे मेनिफ़ेस्ट में जोड़ना होगा. साथ ही, CastMediaOptions में इसका नाम भी सेट करना होगा. इस उदाहरण में, कस्टम कार्रवाइयां दी गई हैं. ये कार्रवाइयां, रिमोट मीडिया प्लेबैक को टॉगल करने, मीडिया बटन दबाने, और अन्य तरह की कार्रवाइयों को बदलती हैं.

// In AndroidManifest.xml
<receiver android:name="com.example.MyMediaIntentReceiver" />
Kotlin
// In your OptionsProvider
var mediaOptions = CastMediaOptions.Builder()
    .setMediaIntentReceiverClassName(MyMediaIntentReceiver::class.java.name)
    .build()

// Implementation of MyMediaIntentReceiver
internal class MyMediaIntentReceiver : MediaIntentReceiver() {
    override fun onReceiveActionTogglePlayback(currentSession: Session) {
    }

    override fun onReceiveActionMediaButton(currentSession: Session, intent: Intent) {
    }

    override fun onReceiveOtherAction(context: Context?, action: String, intent: Intent) {
    }
}
Java
// In your OptionsProvider
CastMediaOptions mediaOptions = new CastMediaOptions.Builder()
        .setMediaIntentReceiverClassName(MyMediaIntentReceiver.class.getName())
        .build();

// Implementation of MyMediaIntentReceiver
class MyMediaIntentReceiver extends MediaIntentReceiver {
    @Override
    protected void onReceiveActionTogglePlayback(Session currentSession) {
    }

    @Override
    protected void onReceiveActionMediaButton(Session currentSession, Intent intent) {
    }

    @Override
    protected void onReceiveOtherAction(Context context, String action, Intent intent) {
    }
}

कस्टम चैनल जोड़ना

सेंडर ऐप्लिकेशन को रिसीवर ऐप्लिकेशन से कम्यूनिकेट करने के लिए, आपके ऐप्लिकेशन को एक कस्टम चैनल बनाना होगा. सेंडर, रिसीवर को स्ट्रिंग मैसेज भेजने के लिए, कस्टम चैनल का इस्तेमाल कर सकता है. हर कस्टम चैनल को एक यूनीक नेमस्पेस से तय किया जाता है. साथ ही, यह urn:x-cast: प्रीफ़िक्स से शुरू होना चाहिए. उदाहरण के लिए, urn:x-cast:com.example.custom. एक से ज़्यादा कस्टम चैनल हो सकते हैं. हर चैनल का नेमस्पेस यूनीक होता है. रिसीवर ऐप्लिकेशन भी उसी नेमस्पेस का इस्तेमाल करके मैसेज भेज और पा सकता है.

कस्टम चैनल को Cast.MessageReceivedCallback इंटरफ़ेस के साथ लागू किया जाता है:

Kotlin
class HelloWorldChannel : MessageReceivedCallback {
    val namespace: String
        get() = "urn:x-cast:com.example.custom"

    override fun onMessageReceived(castDevice: CastDevice, namespace: String, message: String) {
        Log.d(TAG, "onMessageReceived: $message")
    }
}
Java
class HelloWorldChannel implements Cast.MessageReceivedCallback {
    public String getNamespace() {
        return "urn:x-cast:com.example.custom";
    }
    @Override
    public void onMessageReceived(CastDevice castDevice, String namespace, String message) {
        Log.d(TAG, "onMessageReceived: " + message);
    }
}

सेंडर ऐप्लिकेशन के रिसीवर ऐप्लिकेशन से कनेक्ट होने के बाद, कस्टम चैनल को इन तरीकों से बनाया जा सकता है: setMessageReceivedCallbacks

Kotlin
try {
    mCastSession.setMessageReceivedCallbacks(
        mHelloWorldChannel.namespace,
        mHelloWorldChannel)
} catch (e: IOException) {
    Log.e(TAG, "Exception while creating channel", e)
}
Java
try {
    mCastSession.setMessageReceivedCallbacks(
            mHelloWorldChannel.getNamespace(),
            mHelloWorldChannel);
} catch (IOException e) {
    Log.e(TAG, "Exception while creating channel", e);
}

कस्टम चैनल बनने के बाद, सेंडर उस चैनल पर रिसीवर को स्ट्रिंग मैसेज भेजने के लिए, sendMessage तरीके का इस्तेमाल कर सकता है:

Kotlin
private fun sendMessage(message: String) {
    if (mHelloWorldChannel != null) {
        try {
            mCastSession.sendMessage(mHelloWorldChannel.namespace, message)
                .setResultCallback { status ->
                    if (!status.isSuccess) {
                        Log.e(TAG, "Sending message failed")
                    }
                }
        } catch (e: Exception) {
            Log.e(TAG, "Exception while sending message", e)
        }
    }
}
Java
private void sendMessage(String message) {
    if (mHelloWorldChannel != null) {
        try {
            mCastSession.sendMessage(mHelloWorldChannel.getNamespace(), message)
                .setResultCallback( status -> {
                    if (!status.isSuccess()) {
                        Log.e(TAG, "Sending message failed");
                    }
                });
        } catch (Exception e) {
            Log.e(TAG, "Exception while sending message", e);
        }
    }
}

अपने-आप चलने की सुविधा चालू करना

अपने-आप चलने और कतार में लगाने की सुविधा के एपीआई सेक्शन देखें.

यूएक्स विजेट के लिए इमेज चुनने की सुविधा को बदलना

फ़्रेमवर्क के अलग-अलग कॉम्पोनेंट (जैसे, Cast डायलॉग, मिनी कंट्रोलर, और UIMediaController, अगर इसे कॉन्फ़िगर किया गया हो) में, फ़िलहाल कास्ट किए जा रहे मीडिया का आर्टवर्क दिखेगा. आम तौर पर, इमेज आर्टवर्क के यूआरएल, मीडिया के लिए MediaMetadata में शामिल होते हैं. हालांकि, सेंडर ऐप्लिकेशन के पास यूआरएल का कोई दूसरा सोर्स भी हो सकता है.

The ImagePicker क्लास, इमेज की सूची से, इमेज के इस्तेमाल के आधार पर सही इमेज चुनने का तरीका तय करती है. उदाहरण के लिए, सूचना का थंबनेल या फ़ुल स्क्रीन बैकग्राउंड.MediaMetadata डिफ़ॉल्ट ImagePicker लागू करने पर, हमेशा पहली इमेज चुनी जाती है. अगर MediaMetadata में कोई इमेज उपलब्ध नहीं है, तो यह शून्य दिखाता है. आपका ऐप्लिकेशन, ImagePicker की सबक्लास बना सकता है. साथ ही, कोई दूसरा तरीका लागू करने के लिए, onPickImage(MediaMetadata, ImageHints) तरीके को बदल सकता है. इसके बाद, उस सबक्लास को setImagePicker तरीके से CastMediaOptions.Builder में चुना जा सकता है. ImageHints , यूज़र इंटरफ़ेस (यूआई) में दिखाने के लिए चुनी जाने वाली इमेज के टाइप और साइज़ के बारे में, ImagePicker को हिंट देता है.

Cast डायलॉग को पसंद के मुताबिक बनाना

सेशन के लाइफ़साइकल को मैनेज करना

SessionManager , सेशन के लाइफ़साइकल को मैनेज करने का मुख्य प्लैटफ़ॉर्म है. SessionManager सेशन शुरू करने, फिर से शुरू करने, और खत्म करने के लिए, Android MediaRouter के रूट चुनने की स्थिति में होने वाले बदलावों को सुनता है. जब कोई रूट चुना जाता है, तो SessionManager एक Session ऑब्जेक्ट बनाता है और उसे शुरू या फिर से शुरू करने की कोशिश करता है. जब कोई रूट नहीं चुना जाता है, तो SessionManager, मौजूदा सेशन को खत्म कर देगा.

इसलिए, यह पक्का करने के लिए कि SessionManager, सेशन के लाइफ़साइकल को सही तरीके से मैनेज करे, आपको यह पक्का करना होगा कि:

Cast डायलॉग बनाने के तरीके के आधार पर, अतिरिक्त कार्रवाइयां करनी पड़ सकती हैं:

  • अगर Cast डायलॉग, MediaRouteChooserDialog और MediaRouteControllerDialog, का इस्तेमाल करके बनाए जाते हैं, तो ये डायलॉग, MediaRouter में रूट चुनने की सुविधा को अपने-आप अपडेट कर देंगे. इसलिए, कुछ भी करने की ज़रूरत नहीं है.
  • अगर Cast बटन को CastButtonFactory.setUpMediaRouteButton(Context, Menu, int) या CastButtonFactory.setUpMediaRouteButton(Context, MediaRouteButton), का इस्तेमाल करके सेट अप किया जाता है, तो डायलॉग असल में MediaRouteChooserDialog और MediaRouteControllerDialog का इस्तेमाल करके बनाए जाते हैं. इसलिए, कुछ भी करने की ज़रूरत नहीं है.
  • अन्य मामलों में, कस्टम Cast डायलॉग बनाए जाएंगे. इसलिए, MediaRouter में रूट चुनने की स्थिति को अपडेट करने के लिए, आपको ऊपर दिए गए निर्देशों का पालन करना होगा.

कोई डिवाइस न मिलने की स्थिति

अगर कस्टम Cast डायलॉग बनाए जाते हैं, तो आपके कस्टम MediaRouteChooserDialog को, कोई डिवाइस न मिलने की स्थिति को सही तरीके से मैनेज करना चाहिए. डायलॉग में ऐसे इंडिकेटर होने चाहिए जिनसे आपके उपयोगकर्ताओं को यह पता चल सके कि आपका ऐप्लिकेशन अब भी डिवाइस ढूंढने की कोशिश कर रहा है या डिवाइस ढूंढने की कोशिश अब नहीं की जा रही है.

अगर डिफ़ॉल्ट MediaRouteChooserDialog का इस्तेमाल किया जा रहा है, तो कोई डिवाइस न मिलने की स्थिति को पहले से ही मैनेज किया जाता है.

अगले चरण

यहां, उन सुविधाओं के बारे में बताया गया है जिन्हें आपके Android Sender ऐप्लिकेशन में जोड़ा जा सकता है. अब किसी दूसरे प्लैटफ़ॉर्म (iOS या वेब) के लिए सेंडर ऐप्लिकेशन बनाया जा सकता है या Web Receiver ऐप्लिकेशन बनाया जा सकता है.

पीछे जाएं
आउटपुट स्विचर
आगे बढ़ें
ExoPlayer इंटिग्रेशन