תיעוד הפעלה של וידאו ואודיו

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

איך מטפלים בטוקן MediaProjection

‫MediaProjection API מאפשר לאפליקציות לקבל אסימון MediaProjection שנותן להן גישה חד-פעמית לצילום תוכן מסך או אודיו. מערכת ההפעלה Android מבקשת מהמשתמש את ההרשאה שלו לפני שהיא מעניקה את האסימון לאפליקציה.

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

כדי לטפל במצב של אובדן טוקן, צריך לרשום קריאה חוזרת (callback) במופע MediaProjection באמצעות השיטה registerCallback, ולהפסיק את ההקלטה כשמתבצעת קריאה לשיטה onStop.

מידע נוסף זמין במאמר בנושא הקרנת מדיה.

צילום סרטון

באפליקציה לדוגמה ScreenCapture מוסבר איך להשתמש ב-Media Projection API כדי לצלם את המסך של מכשיר בזמן אמת ולהציג אותו ב-SurfaceView.

אתם יכולים להשתמש ב-DevicePolicyManager כדי למנוע הקלטת מסך. בחשבונות ארגוניים (Android for Work), האדמין יכול להשבית את איסוף הנתונים של העוזר הדיגיטלי בפרופיל העבודה באמצעות השיטה setScreenCaptureDisabled.

בשיעור התכנות ניהול מכשירי Android ללא אפליקציה מוסבר איך לאסור צילומי מסך.

קליטת הפעלת אודיו

‫AudioPlaybackCapture API הושק ב-Android 10. ממשק ה-API הזה מאפשר לאפליקציות להעתיק את האודיו שמופעל באפליקציות אחרות. התכונה הזו מקבילה לצילום מסך, אבל היא מיועדת לאודיו. תרחיש השימוש העיקרי הוא באפליקציות סטרימינג שרוצות ללכוד את האודיו שמופעל במשחקים.

הערה: ממשק ה-API‏ AudioPlaybackCapture לא משפיע על זמן האחזור של האפליקציה שהאודיו שלה נלכד.

פיתוח אפליקציה ללכידת נתונים

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

  • לאפליקציה צריכה להיות ההרשאה RECORD_AUDIO.
  • האפליקציה צריכה להציג את ההודעה שמוצגת על ידי MediaProjectionManager.createScreenCaptureIntent(), והמשתמש צריך לאשר אותה.
  • אפליקציות הצילום וההפעלה צריכות להיות באותו פרופיל משתמש.

כדי ללכוד אודיו מאפליקציה אחרת, האפליקציה שלכם צריכה ליצור אובייקט AudioRecord ולהוסיף לו אובייקט AudioPlaybackCaptureConfiguration. בצע את השלבים הבאים:

  1. מתקשרים אל AudioPlaybackCaptureConfiguration.Builder.build() כדי ליצור AudioPlaybackCaptureConfiguration.
  2. מעבירים את ההגדרה אל AudioRecord על ידי קריאה ל-setAudioPlaybackCaptureConfig.

שליטה בהקלטת אודיו

האפליקציה יכולה לשלוט בסוגי התוכן שהיא יכולה להקליט, ובסוגים אחרים של אפליקציות שיכולות להקליט את ההפעלה שלה.

הגבלת הצילום לפי תוכן האודיו

אפליקציה יכולה להגביל את האודיו שהיא יכולה ללכוד באמצעות השיטות הבאות:

  • מעבירים AUDIO_USAGE אל AudioPlaybackCaptureConfiguration.addMatchingUsage() כדי לאפשר ללכוד שימוש ספציפי. אפשר לקרוא לשיטה כמה פעמים כדי לציין יותר משימוש אחד.
  • מעבירים AUDIO_USAGE אל AudioPlaybackCaptureConfiguration.excludeUsage()‎ כדי למנוע את התיעוד של השימוש הזה. אפשר לקרוא לשיטה כמה פעמים כדי לציין יותר משימוש אחד.
  • מעבירים מזהה ייחודי (UID) אל AudioPlaybackCaptureConfiguration.addMatchingUid() כדי ללכוד רק אפליקציות עם מזהה ייחודי ספציפי. מפעילים את ה-method כמה פעמים כדי לציין יותר מ-UID אחד.
  • מעבירים מזהה ייחודי (UID) אל AudioPlaybackCaptureConfiguration.excludeUid()‎ כדי למנוע את הלכידה של המזהה הייחודי הזה. מפעילים את ה-method כמה פעמים כדי לציין יותר מ-UID אחד.

שימו לב שאי אפשר להשתמש בשיטות addMatchingUsage() ו-excludeUsage() ביחד. צריך לבחור באחת מהאפשרויות. באופן דומה, אי אפשר להשתמש ב-addMatchingUid() וב-excludeUid() בו-זמנית.

הגבלת הצילום על ידי אפליקציות אחרות

אתם יכולים להגדיר אפליקציה כדי למנוע מאפליקציות אחרות לצלם את האודיו שלה. אפשר להקליט את האודיו שמגיע מאפליקציה רק אם האפליקציה עומדת בדרישות הבאות:

שימוש

הנגן שמפיק את האודיו צריך להגדיר את השימוש לערך USAGE_MEDIA,‏ USAGE_GAME או USAGE_UNKNOWN.

מדיניות צילום

מדיניות הצילום של הנגן צריכה להיות AudioAttributes.ALLOW_CAPTURE_BY_ALL, שמאפשרת לאפליקציות אחרות לצלם את ההפעלה. אפשר לעשות זאת בכמה דרכים:

אם מתקיימים התנאים המוקדמים האלה, אפשר לצלם כל אודיו שמופק על ידי הנגן.

השבתה של תיעוד המערכת

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

הגדרת מדיניות בזמן ריצה

אפשר להתקשר אל AudioManager.setAllowedCapturePolicy() כדי לשנות את מדיניות הצילום בזמן שאפליקציה פועלת. אם מתבצעת הפעלה של MediaPlayer או AudioTrack כשמבצעים קריאה לשיטה, האודיו לא מושפע. כדי שהשינוי במדיניות ייכנס לתוקף, צריך לסגור את הנגן או את הרצועה ולפתוח אותם מחדש.

מדיניות = קובץ מניפסט + AudioManager + AudioAttributes

מדיניות איסוף הנתונים יכולה להיות מוגדרת בכמה מקומות, ולכן חשוב להבין איך נקבעת המדיניות בפועל. המערכת תמיד תחיל את מדיניות הלכידה הכי מגבילה. לדוגמה, אפליקציה שקובץ המניפסט שלה כולל את ההרשאה setAllowedCapturePolicy="false" לעולם לא תאפשר לאפליקציות שאינן אפליקציות מערכת ללכוד את האודיו שלה, גם אם ההרשאה AudioManager#setAllowedCapturePolicy מוגדרת לערך ALLOW_CAPTURE_BY_ALL. באופן דומה, אם המדיניות AudioManager#setAllowedCapturePolicy מוגדרת לערך ALLOW_CAPTURE_BY_ALL ובקובץ המניפסט מוגדר הערך setAllowedCapturePolicy="true", אבל הרכיבים AudioAttributes של נגן המדיה נוצרו עם הערך AudioAttributes.Builder#setAllowedCapturePolicy(ALLOW_CAPTURE_BY_SYSTEM), אז אפליקציות שאינן אפליקציות מערכת לא יוכלו לצלם את נגן המדיה הזה.

בטבלה הבאה מסוכמת ההשפעה של מאפיין המניפסט והמדיניות האפקטיבית:

allowAudioPlaybackCapture ALLOW_CAPTURE_BY_ALL ALLOW_CAPTURE_BY_SYSTEM ALLOW_CAPTURE_BY_NONE
true כל אפליקציה מערכת בלבד לא מתבצע צילום
false מערכת בלבד מערכת בלבד לא מתבצע צילום