Medya denetleyici test uygulamasını kullanma

Android telefonlarda Google Asistan'la sesli şekilde etkileşimde bulunan medya uygulamaları, arabalar, TV'ler ve kulaklıklar Android medya oturumu API'leri tarafından desteklenmektedir ve medya işlemlerini kullanır. Medya işlemi yaşam döngüsünü takip etmek zor olabilir. Aramada yapılan basit bir şarkı bile aşağıdaki örnekteki gibi istek, bir şeylerin ters gidebileceği birçok ara adım içerir: basitleştirilmiş zaman çizelgesi:

Medya İşlemi Yaşam Döngüsü

Şekil 1. Medya İşlemi Yaşam Döngüsü

Medya Denetleyici Testi (MCT) Android'de medya oynatmanın inceliklerini test etmenize olanak tanırken medya oturumu uygulamanızı doğrulama.

MCT, uygulamanızın MediaController ile ilgili bilgileri (ör. PlaybackState ve meta verileri içerir ve uygulamalar arası medya kontrollerini test etmek için kullanılabilir. MCT ayrıca bir doğrulama testi çerçeve kalite güvencesi testlerinizi otomatikleştirmenizi sağlar.

MCT'yi kullanabilmeniz için uygulamanızın bir medya tarayıcı hizmeti olması gerekir ve MCT'nin bağlanmasına izin vermeniz gerekir. Görüntüleyin Medya tarayıcı hizmeti oluşturma konulu videomuzu izleyin.

MCT'yi başlatma

MCT Lansman Sayfası.
Şekil 2. MCT Lansman Sayfası

MCT'yi başlattığınızda iki liste görürsünüz:

  • Active MediaSessions: MCT'yi başlattığınızda bu liste başlangıçta boş olur "Hiçbir medya uygulaması bulunamadı. Bildirim Etkin medya oturumlarını taramak için dinleyici izni gerekir." Şu işlemler için Ayarlar'ı tıklayın: İzinler ekranına gidip MCT için izni etkinleştirin.
  • MediaTarayıcı Hizmeti Uygulamaları - Bu liste, bir medya tarayıcısı hizmeti uygulayan uygulamaları gösterir. Bir medya tarayıcısı hizmeti kullandıysanız uygulamanız bu listede görünür Ancak MCT'yi yalnızca uygulamanızı tüm reklam öğelerini kabul edecek şekilde yapılandırdıysanız kullanabilirsiniz bağlantılarınız veya MCT'yi izin verilenler listesine eklemeniz gerekir. Bkz. onGetRoot() konulu videomuzu izleyin.

Bir telefon uygulamasını manuel olarak test etme

MCT'nin, uygulamanızın medya tarayıcısı hizmetine bağlanmasına izin verdiyseniz uygulamanız listesi, medya tarayıcısı hizmet listesi uygulamaları listesinde görünür. Orada bulun ve uygulamanızı arka planda başlatmak için Kontrol'ü tıklayın.

Aksi takdirde, önce uygulamanızı arka planda kendiniz başlatmanız ve ardından Etkin medya oturumları listesinde ne zaman görüneceğini kontrol.

Test hazırlığı ve oynama

MCT, uygulamanızı kontrol etmeye başladığında uygulamanın mevcut oturumunu gösterir meta veri: şu anda seçili medya ve oturumda yapılan işlemler hazırlarsınız.

Kontrol Sayfası.
Şekil 3. Kontrol Sayfası

MCT kontrolleri sayfasının üst kısmında, seçim yapabileceğiniz bir açılır menü bulunur. Arama, URI, Medya Kimliği veya Yok (metin alanı ile birlikte) öğesini kullanın. birini seçin.

Metin alanının hemen altındaki Hazırla ve Oynat düğmeleri ile uygun aramalar (onPrepare(), onPrepareFromSearch(), onPrepareFromUri(), onPrepareFromMediaId(), onPlay(), onPlayFromSearch(), onPlayFromUri(), onPlayFromMediaId()) görürsünüz.

Ses odağı test ediliyor

İyi çalışan bir medya uygulaması sesleri işleyebilmelidir. odak. Ses odağını test etmek için uygulamanızla birlikte başka bir ses uygulaması çalıştırmak MCT kontrolleri sayfasında şunlar yer alır: ses odağı isteğinde bulunan ve serbest bırakan düğme.

Ses odağını test etmek için şu adımları uygulayın:

  1. Üç süre ipucundan birini seçmek için Ses Odağı açılır menüsünü kullanın. AUDIOFOCUS_GAIN, AUDIOFOCUS_GAIN_TRANSIENT veya AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK.
  2. Odaklanma isteğinde bulunmak için düğmeye basın.
  3. Odağı bırakmak için düğmeye tekrar basın.

Aktarım kontrollerini test etme

Taşıma Denetimlerini Test Etme.
Şekil 4. Taşıma Denetimlerini Test Etme

MCT'nin kullanıcı arayüzü görünümünü görüntülemek için sola kaydırın. Bu görünüm standart medya denetleyicisi aktarım düğmelerine sahiptir ve oturumun program imajı ve verileridir. Devre dışı bırakılan ulaşım düğmeleri daire içine alınır portakal. Diğer tüm işlevler etkin.

Aktarım düğmelerini kullanarak oynatıcınızı test edin. Aktarım düğmelerinin durumu beklendiği gibi değişmelidir. Örneğin, OYNAT düğmesine bastığınızda devre dışı bırakılır ve DURDUR ile DURDUR düğmeleri etkin hale gelir.

İsteğe bağlı işlemlerin gösterildiği bir görünüm için tekrar sola kaydırın. Her işlem etkin olup olmadığını gösteren bir kontrole sahiptir. Etkinse şunları yapabilirsiniz: öğesini tıklayarak işlemi gerçekleştirebilirsiniz.

Medya tarayıcısı hizmetine sahip uygulamaların listesinden bağlandıysanız Uygulamanızın içeriğinde yukarı ve aşağı ilerlemenize olanak tanıyan görünümler için iki kez daha sola kaydırın girin veya içerik ağacında arama yapın.

Video uygulamasını manuel olarak test etme

Video uygulaması denetleyicilerini test etmek için bölünmüş ekran modunu kullanın. Önce video uygulamanızı açın MCT'yi bölünmüş ekran modunda açabilirsiniz.

Doğrulama testlerini çalıştırma

Doğrulama test çerçevesi, doğrulama testlerini test etmek üzere kullanabileceğiniz Medya uygulamanızın bir oynatma isteğine doğru yanıt verdiğinden emin olun.

Bir telefon uygulamasını test etme

Test Düğmesi.
Şekil 5. Test Düğmesi

Doğrulama testlerine erişmek için medyanızın yanındaki Test et düğmesini tıklayın. uygulamasını indirin.

MCT durumu

Medya Kontrol Durumu.
Şekil 6. Medya Kontrol Durumu

Sonraki görünümde, MCT'nin MediaController, örneğin PlaybackState, meta veri ve sıra. Açık artırmada tıklayın. Soldaki düğme, ayrıştırılabilir ve biçimlendirilmiş günlükler. Sağdaki düğme, görünümü yenileyerek en güncel bilgilere sahip olursunuz.

Test seçme

Test Seçim Sayfası.
Şekil 7. Test Seçim Sayfası

Sola kaydırarak doğrulama testleri görünümüne ulaşırsınız. Burada, mevcut testlerin kaydırılabilir bir listesini görün. Bir test, Şekil 7'de gösterilen arama testinden yalnızca bir sorgu dizesini girmek için bir metin alanı.

MCT, aşağıdaki medya işlemlerine ilişkin testleri içerir ve daha fazla test projeye devamlı olarak eklenecek:

  • Oynat
  • Arama'dan Oynat
  • Medya Kimliğinden Oynat
  • URI'dan Oynat
  • Duraklat
  • Durdur
  • Sonrakine Atla
  • Öncekine Atla
  • Öğeyi Sıraya Atla
  • Şuraya sar:

Test sonuçları

Başarılı Test Sonucu.
Şekil 8. Başarılı Test Sonucu

Görünümün alt kısmındaki sonuçlar alanı başlangıçta boştur. Bu rapor, elde etmeye çalışır. Örneğin, oynatmayı arama testinden çalıştırmak için metin alanına bir arama sorgusu girin ve Testi Çalıştır'ı tıklayın. Aşağıdakiler ekran görüntüsü başarılı bir test sonucunu gösteriyor.

Android TV uygulamasını test etme

Android TV'de MCT'yi başlattığınızda yüklü medya uygulamalarının listesini görürsünüz. Bir uygulamanın bu listede yalnızca medya tarayıcısı kullanıyorsa görüneceğini unutmayın geliştirmenizi sağlar.

TV'de MCT Lansman Sayfası

Şekil 9. TV'de MCT Lansman Sayfası

Bir uygulama seçtiğinizde test ekranına yönlendirilirsiniz. Bu ekranda, sağda doğrulama testlerinin listesi görüntülenir.

TV'de Doğrulama Testleri Sayfası

Şekil 10. TV'de Doğrulama Testleri Sayfası

Bir test gerçekleştirdiğinizde, ekranın sol tarafında ve MediaController'ı seçin. Daha ayrıntılı bilgi için Logcat'teki MCT günlüklerini kontrol edin.

TV'de Test Bilgileri Sayfası

Şekil 11. TV'deki Test Bilgileri Sayfası

Sorgu gerektiren testler klavye simgesiyle işaretlenmiştir. Bu seçeneklerden birini tıkladığınızda Bu testler sorgu için bir giriş alanı açar. Testi çalıştırmak için Enter'a basın.

Metin girişini kolaylaştırmak için adb komutu da kullanabilirsiniz:

adb shell input text your-query

"%s" kullanabilirsiniz kullanabilirsiniz. Örneğin, komutu, "hello world" metnini ekler ekler.

adb shell input text hello%sworld

Test oluşturma

Yararlı olduğunu düşündüğünüz daha fazla test içeren bir pull isteği gönderebilirsiniz. Yeni testlerin nasıl oluşturulacağını öğrenmek için MCT GitHub Wiki ve doğrulama testi talimatları inceleyin.

Lütfen katkıda bulunma talimatlarını inceleyin.

Ek kaynaklar

MCT'nin, medya API'lerini uygulayan uygulamalarla birlikte kullanılması amaçlanmıştır. Bkz. Evrensel Android Müzik Çalar uygulama örneğine bakalım.

Hata düzeltmeleri ve iyileştirmeler yapmaktan memnuniyet duyarız. Daha fazla bilgi için lütfen katkıda bulunma talimatlarını inceleyin.