הוספה של תכונות מתקדמות לאפליקציית Android

הפסקות למודעות

ה-SDK של Android Sender תומך בהפסקות למודעות ובמודעות נלוות זרם מדיה נתון.

לצפייה סקירה כללית של הפסקות למודעות אצל מקלטי אינטרנט מידע על אופן הפעולה של הפסקות למודעות.

אפשר לציין הפסקות גם בשולח וגם בנמען, אבל מומלץ לציין אותן בנתב האינטרנט ובנתב Android TV כדי לשמור על התנהגות עקבית בפלטפורמות השונות.

ב-Android, מציינים הפסקות למודעות בפקודת טעינה באמצעות AdBreakClipInfo וגם AdBreakInfo:

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)

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" />

// 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) {
    }
}

// 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 ממשק:

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")
    }
}

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:

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

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

לאחר יצירת הערוץ המותאם אישית, השולח יכול להשתמש sendMessage שיטה לשליחת מחרוזות הודעות למקבל התשלום בערוץ הזה:

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)
        }
    }
}

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);
        }
    }
}

תמיכה בהפעלה אוטומטית

מעבר לקטע הפעלה אוטומטית ו ממשקי API לרשימת תורים.

שינוי ברירת המחדל לבחירת תמונות בווידג'טים של חוויית המשתמש

רכיבים שונים של המסגרת (כלומר תיבת הדו-שיח של Cast, הבקר המיני ו-UIMediaController, אם הם מוגדרים כך) יציגים גרפיקה של המדיה שמעבירים כרגע. בדרך כלל, כתובות ה-URL לגרפיקה של התמונה נכלל ב-MediaMetadata עבור המדיה, אבל ייתכן שבאפליקציית השולח יש מקור חלופי של כתובות ה-URL.

ImagePicker מגדיר אמצעי לבחירת תמונה מתאימה מתוך רשימת התמונות. ב-MediaMetadata, בהתאם לשימוש בתמונה, לדוגמה, התראה תמונה ממוזערת או רקע של מסך מלא. הטמעת ברירת המחדל של ImagePicker בוחר תמיד בתמונה הראשונה, או מחזירה null אם אין תמונה זמינה MediaMetadata. האפליקציה שלך יכולה לתת מחלקה משנית של ImagePicker ולבטל את onPickImage(MediaMetadata, ImageHints) כדי לספק הטמעה חלופית, ואז לבחור את המחלקה המשנית עם setImagePicker ל-CastMediaOptions.Builder. ImageHints מספק רמזים ל-ImagePicker לגבי הסוג והגודל של התמונה נבחר להצגה בממשק המשתמש.

התאמה אישית של תיבות הדו-שיח של הפעלת Cast

ניהול מחזור החיים של הסשן

SessionManager הוא המקום המרכזי לניהול מחזור החיים של הסשן. SessionManager האזנות ל-Android MediaRouter מצב בחירת המסלול משתנה לסשנים של התחלה, המשך וסיום. כשבוחרים מסלול, SessionManager יוצר אובייקט Session ומנסה להפעיל אותו או להמשיך אותו. כשמבטלים בחירה של מסלול, SessionManager יסיים את הסשן הנוכחי.

לכן, כדי להבטיח שמחזור החיים של הסשנים ינוהל כראוי ב-SessionManager, חייבת לוודא ש:

• בתיבת הדו-שיח לבחירת מסלול, צריך להפעיל את הקריאה MediaRouter.selectRoute(MediaRouter.RouteInfo) כשמשתמש בוחר מכשיר.
• בתיבת הדו-שיח של בקר הנתיב (בשדה מחובר הסמוי או הפעלת Cast state), לשלוח קריאה MediaRouter.unselect(int) כשהמשתמש מפסיק את ההעברה.

בהתאם לאופן שבו יוצרים את תיבות הדו-שיח של הפעלת Cast, ייתכן שיהיה צורך לבצע פעולות נוספות בוצע:

• אם יוצרים תיבות דו-שיח של הפעלת Cast באמצעות MediaRouteChooserDialog וגם MediaRouteControllerDialog, תיבות הדו-שיח האלה יעדכנו את בחירת המסלול ב-MediaRouter באופן אוטומטי, כך שלא צריך לעשות שום דבר.
• אם הגדרתם את לחצן ההעברה באמצעות CastButtonFactory.setUpMediaRouteButton(Context, Menu, int) או CastButtonFactory.setUpMediaRouteButton(Context, MediaRouteButton), תיבת הדו-שיח נוצרת בפועל באמצעות MediaRouteChooserDialog ו-MediaRouteControllerDialog, כך שאין צורך לבצע שום פעולה.
• במקרים אחרים, צריך ליצור תיבות דו-שיח מותאמות אישית להפעלת Cast, כך שיהיה צורך צריך לפעול לפי ההוראות שלמעלה כדי לעדכן את מצב בחירת המסלול MediaRouter

מצב אפס מכשירים

אם יוצרים תיבות דו-שיח מותאמות אישית להפעלת Cast, MediaRouteChooserDialog צריך לטפל כראוי במקרה של אפס מכשירים נמצא. תיבת הדו-שיח צריכה לכלול אינדיקטורים שמבהירים למשתמשים מתי האפליקציה עדיין מנסה למצוא מכשירים וכשניסיון הגילוי נכשל במצב פעיל יותר.

אם משתמשים בברירת המחדל של MediaRouteChooserDialog, מצב אפס המכשירים כבר מטופל.

השלבים הבאים

הגענו לסוף הסיכום של התכונות שאפשר להוסיף לאפליקציה של השולח ב-Android. עכשיו אפשר לפתח אפליקציית שולח לפלטפורמה אחרת (iOS או אינטרנט), או לפתח אפליקציה של WebReceiver.