נגן אודיו בסיסי

בפוסט זה נציג את פעולת ה-MediaPlayer ונבנה נגן אודיו בסיסי. ה-MediaPlayer הוא class הכולל גם אפשרות טיפול בוידאו. ראה קישור לאתר המפתחים של אנדרואיד.
הנגן מנגן שיר אחד בלבד, של הזמר ריי ווטסון.  שם השיר: All My Desires. אני מודה שהכרתי אותו רק בעקבות  חיפושי אחרי קבצי אודיו חופשיים להורדה חינם ובאופן חוקי.
הפורמט של השיר הוא mp3. גם midi, pcm ו -ogg vorbis נתמכים.
את הקובץ allmydesire.mp3 יש לשמור תחת  res/raw.
הנגן שלנו יכיל כפתור יחיד להפעלה והפסקת ההשמעה. הוא כולל תצוגה של אורך השיר. הוא יזהה את סיום השיר וידפיס הודעה על המסך.
הוספתי לתצוגה גם נתונים על השיר ותמונה של הזמר. התצוגה של הנגן נראית כך:

מעבר לשמירת קובץ המוסיקה תחת /res/raw ושמירת התמונה תחת res/draw, הקבצים שבהם נתעניין הם קובץ ה-layout ואובייקט הג'אווה היחיד.
ב-layout אין שום חידוש. מופיעים שם 3 סוגים של אלמנטים: Button, שלושה  TextView ו-ImageView. לא אציג את הקובץ כאן הפעם. הוא נמצא כמובן בחבילת הקבצים של הפרויקט הניתנת להורדה בהקלקה על הקישור.
שים לב, הקבצים הפעם בגודל 12MB, בגלל קבצי ה-mp3.

תוכן הקובץ הכולל את ה-class היחידי בפרויקט מוצג להלן.

1. 
   
2. 
   
3. public class myAudioMediaPlayer extends Activity {
4.     MediaPlayer mp;
5.    
6.     Button         playButton;
7.     Button         stopButton;
8.     Button         setMessageButton;
9.     Button         clearMessageButton;
10.     TextView    textBox;
11.     TextView    textBox2;
12.     TextView    textBox3;
13.    
14.     /** Called when the activity is first created. */
15.     @Override
16.     public void onCreate(Bundle savedInstanceState) {
17.         super.onCreate(savedInstanceState);
18.         setContentView(R.layout.main);
19.         playButton = (Button)findViewById(R.id.play_button);
20.         textBox       = (TextView)findViewById(R.id.text_box);
21.         textBox2       = (TextView)findViewById(R.id.text_box2);
22.         textBox3       = (TextView)findViewById(R.id.text_box3);
23.          mp = MediaPlayer.create(this, R.raw.allmydesire);
24.           String min = String.valueOf((mp.getDuration()/1000)/60);
25.          String sec = String.valueOf((mp.getDuration()/1000)%60);
26.          textBox2.setText( " All My Desire :"+"שם השיר");
27.          textBox3.setText( " Ray Watson :"+"שם המבצע");
28.          if(10> (mp.getDuration()/1000)%60)
29.              textBox.setText(min +":0"+sec + " :"+"משך השיר");
30.          else
31.              textBox.setText(min +":"+sec + " :"+"משך השיר");
32.          mp.setOnCompletionListener(new
33.                  MediaPlayer.OnCompletionListener() {
34.                  public void onCompletion(MediaPlayer mp)
35.                  {
36.                      mp.stop();
37.                      textBox.setText("Song is Over. You can start again");
38.                      playButton.setText("נגן");
39.                      createMediaPlayerHelper();
40.                  }
41.                  });
42.         
43.         playButton.setOnClickListener(new View.OnClickListener() {
44.             public void onClick(View view) {
45.                 if(mp.isPlaying()){
46.                     mp.pause();
47.                     playButton.setText("נגן");
48.                 }
49.                 else{
50.                     mp.start();
51.                     playButton.setText("הפסק");
52.                 }
53.              }
54.         });
55.  
56.     }
57.     private void createMediaPlayerHelper(){
58.         mp = MediaPlayer.create(this, R.raw.allmydesire);
59.     }
60. }

המתודה העיקרית היא onCreate ויש גם מתודת עזר בשם createMediaPlayerHelper
הסבר לinCreate :
חלק 1:
עד שורה 23, אלה בעיקר האיתחולים מהסוג הרגיל, של אלמנטי ה- UI.
חלק 2: יצירת האובייקט של ה- MediaPlayer עם (create(Context context, int resid, כשה-id לקוח מה-class R.java.
השורות 2 ו 3, מחשבות את אורך השיר בדקות ושניות על סמך המתודה getDuration.

1. mp = MediaPlayer.create(this, R.raw.allmydesire)
2. String min = String.valueOf((mp.getDuration()/1000)/60)
3. String sec = String.valueOf((mp.getDuration()/1000)%60)

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

1.         textBox2.setText( " All My Desire :"+"שם השיר");
2.          textBox3.setText( " Ray Watson :"+"שם המבצע");
3.          if(10> (mp.getDuration()/1000)%60)
4.              textBox.setText(min +":0"+sec + " :"+"משך השיר");
5.          else
6.              textBox.setText(min +":"+sec + " :"+"משך השיר");

חלק 4: callback  שיופעל עם סיום השיר. שימוש במתודה  setOnCompletionListener לרגיסטרציה של ה-callback. שהשיר נגמר עוצרים את הנגן (שורה 5), מדפיים הודעה ל-UI (שורה 6), הופכים את הכותרת שעל הכפתור מ"הפסק" ל"נגן", קוראים למתודת השירות (שורה 8), שיוצרת MediaPlayer מחדש. (הערה -יתכן שמספיק לעשות prepare - לבדוק)

1.         mp.setOnCompletionListener(new
2.                  MediaPlayer.OnCompletionListener() {
3.                  public void onCompletion(MediaPlayer mp)
4.                  {
5.                      mp.stop();
6.                      textBox.setText("Song is Over. You can start again");
7.                      playButton.setText("נגן");
8.                      createMediaPlayerHelper();
9.                  }
10.                  });

חלק 5: יצירת callback עבור כפתור השליטה בנגן.

עם הלחיצה על הכפתור מפעילים את המתודה pause (שורה 4) או start (שורה 8), לפי התוצאה של המתודה isPlaying- שורה 3. באותה ההזדמנות הופכים את הכיתוב על הכפתור מ-"נגן" ל- " הפסק" ולהפך (שורות 5 ו-9).

1.        playButton.setOnClickListener(new View.OnClickListener() {
2.             public void onClick(View view) {
3.                 if(mp.isPlaying()){
4.                     mp.pause();
5.                     playButton.setText("נגן");
6.                 }
7.                 else{
8.                     mp.start();
9.                     playButton.setText("הפסק");
10.                 }
11.              }
12.         });

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