HelloMoon应用介绍

HelloMoon是《Android权威编程指南》一书中的一个应用，通过这个应用，可以学习到如下知识点：

• 通过MediaPlayer播放音频文件；
• 使用 setRetainInstance(boolean) 方法保留fragment实例；
• 在res资源目录下使用配置修饰符，使应用本地化。

---

应用只包含一个activity/fragment，点击播放，将播放一段音频，点击停止，音频将停止播放。最终效果如下所示：

---

---

本文将分为下面几个部分：

1. fragment布局及逻辑；
2. 封装MediaPlayer类，实现音频播放；
3. 介绍配置修饰符的使用规则。

---

fragment逻辑和布局

首先为fragment设置布局：

<!-- fragment_hello_mooon.xml -->
<!-- fragment的布局 -->

<TableLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".HelloMoonFragment" >

    <ImageView
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout_weight="1"
        android:contentDescription="@string/hellomoon_description"
        android:scaleType="centerInside"
        android:src="@drawable/armstrong_on_moon" />

    <TableRow
        android:layout_weight="0"
        android:gravity="center|bottom" >

        <Button
            android:id="@+id/hellomoon_playButton"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="@string/hellomoon_play" >
        </Button>

        <Button
            android:id="@+id/hellomoon_stopButton"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="@string/hellomoon_stop" />
    </TableRow>

</TableLayout>

---

上述XML需注意：

• 无需为TableRow设置宽、高，宽高均由其父容器决定；
• 设置layout_weight = “0”表示为TableRow分配的空间比重将由其子组件的大小决定。

---

fragment逻辑：

//HelloMoonFragment.java
//fragment的实现逻辑

public class HelloMoonFragment extends Fragment {
    private Button mPlayButton;
    private Button mStopButton;
    private AudioPlayer mAudioPlayer = new AudioPlayer();;

    @Override
    public void onCreate(@Nullable Bundle savedInstanceState) {
        // TODO Auto-generated method stub
        super.onCreate(savedInstanceState);
        // 该方法可Fragment实例一直存在（即保存了MediaPlayer实例），不会因为旋转屏幕而被销毁
        setRetainInstance(true);
    }

    @Override
    @Nullable
    public View onCreateView(LayoutInflater inflater,
            @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
        // TODO Auto-generated method stub

        View view = inflater.inflate(R.layout.fragment_hello_moon, container,
                false);
        mPlayButton = (Button) view.findViewById(R.id.hellomoon_playButton);
        mPlayButton.setOnClickListener(new OnClickListener() {

            @Override
            public void onClick(View v) {
                // TODO Auto-generated method stub
                mAudioPlayer.play(getActivity());

            }
        });
        mStopButton = (Button) view.findViewById(R.id.hellomoon_stopButton);
        mStopButton.setOnClickListener(new OnClickListener() {

            @Override
            public void onClick(View v) {
                // TODO Auto-generated method stub
                mAudioPlayer.stop();
            }
        });
        return view;

    }

    // HelloMoonFragment被销毁后，MediaPlayer仍可不停播放，因为MediaPlayer运行在不同的线程上，故需手动停止
    @Override
    public void onDestroy() {
        // TODO Auto-generated method stub
        super.onDestroy();
        mAudioPlayer.stop();
    }

}

---

代码为两个按钮绑定了监听器，用于控制音频的播放和停止，同时还创建了一个AudioPlayer对象，该对象封装了用于控制音频、视频播放的类MediaPlayer。下面是AudioPlayer的逻辑实现：

public class AudioPlayer {
    private MediaPlayer mPlayer;

    public void stop() {
        if (mPlayer != null) {
            mPlayer.release();
            mPlayer = null;
        }
    }

    public void play(Context c) {
        // 避免多次单击Play按钮创建多个MediaPlayer实例的情况发生
        stop();
        mPlayer = MediaPlayer.create(c, R.raw.one_small_step);
        // 监听MediaPlayer播放情况，当播放完成后，立即释放MediaPlayer实例占用的资源
        mPlayer.setOnCompletionListener(new OnCompletionListener() {

            @Override
            public void onCompletion(MediaPlayer mp) {
                // TODO Auto-generated method stub
                stop();

            }
        });
        mPlayer.start();
    }

}

---

• MediaPlayer是独占性的：被MediaPlayer绑定了的资源将无法被其他类使用，所以，在不需要MediaPlayer的时候，要及时释放其绑定的资源；
• 使用MediaPlayer.setOnCompletionListener(OnCompletionListener listener)，为MediaPlayer绑定监听器，当资源播放完成后，OnCompletionListener 接口中的方法onCompletion(MediaPlayer mp)被回调，可在该方法中处理MediaPlayer的善后工作。
• 当屏幕配置发生改变时（如旋转屏幕，系统语言改变等），fragment中播放的音频（MediaPlayer）将随fragment的实例被一并销毁，为了保证音频不被重置，应在Fragment.onCreate()方法中调用方法setRetainInstance(true)，该方法（默认情况下参数为false）可保证当fragment的宿主activity被销毁并重建时，其托管的fragment实例不被销毁，而只是将该fragment的视图随activity销毁。在activity销毁并重建实例的时间很短，fragment没有被任何activity托管，因此setRetainInstance(true)的适用条件仅是当设备的配置发生改变时，托管的activity正在被销毁的情形。另外，如需持久地保存数据，应使用回调方法onSaveInstanceState方法，该方法用于保存并回复应用的UI状态，有关onSaveInstanceState的用法，请参见我的博文《GeoQuiz的个人见解》。onSaveInstanceState与setRetainInstance方法的主要区别是数据可以保存多久，若只是短暂的保留数据，能应对设备配置的改变，使用后者就行了，因为fragment保留数据的时间就是该fragment的生命周期的时间；若需要持久地保存数据，就得用前者：当用户离开应用后，如系统因回收内存需要销毁activity，则保留的fragment也会被随之销毁。

---

配置修饰符的使用

---

不同国家和地区有自己的语言和APP使用习惯；不同设备的屏幕大小、分辨率需要使用的图片大小不同（屏幕显示密度）；不同版本的设备需要为其兼容版本的主题（API级别），等等。通过配置修饰符，可以实现上面的要求，下面是具有配置修饰符的设备特征：

1. 移动国家代码（通常附有移动网络码）
2. 语言代码（通常附有地区代码）
3. 布局方向
4. 最小宽度
5. 可用宽度
6. 可用高度
7. 屏幕尺寸
8. 屏幕纵横比
9. 屏幕方位
10. UI模式
11. 夜间模式
12. 屏幕显示目睹
13. 触摸屏类型
14. 键盘可用性
15. 首选输入法
16. 导航键可用性
17. 非文本导航方法
18. API级别

---

下面是HelloMoon应用中，res目录下使用配置修饰符的情形：

---

• res/raw、res/layout、res/drawable、res/values目录表示在缺省情况下的配置修饰符，例如，当系统语言切换至中文、而res目录中并没有提供values-zh目录时，应用将使用res/values中的内容；再比如，除非设备本版本等于或高于API 11，否则应用将使用默认的res/values中的资源；
• 可以在同一资源目录上使用读个配置修饰符，各配置修饰符必须按照上述优先级的顺序排列，如res/values-zh-land；但res/values-land-zh无效；
• 配置修饰符的匹配规则如下：
  –1、首先排除不兼容的目录——比如，在竖屏浏览应用时，res/values-land和values-zh-land目录中的内容将被忽略。特别注意的是，Android对屏幕显示密度采用了不同的处理方式，该兼容匹配规则不适用于它，Android会选择其认为最合适的资源来匹配设备配置，也就是说，系统最终选择的匹配方案可能与开发者适配的方案有出入。
  –2、按优先级筛选不兼容目录：系统会按优先级从高到低的顺序匹配修饰符，若没有为该优先级设置修饰符，则将该优先级忽略，继续按次优先级的修饰符进行筛选：当系统语言设置为中文，并将屏幕旋转至横屏时，系统会这样匹配修饰符：首先系统会寻找res目录下是否有被优先级最高的MCC修饰的目录（移动国家代码 MCC:Mobile Country Code），显然在本应用中没有，故比较次优先级的“语言代码”，由于系统语言是中文，故筛选出res/values-zh、res/values-zh-land目录，接着筛选下一个优先级“布局方向”，由于屏幕为横屏，最终筛选的结果是使用res/values-zh-land目录。当没有任何可匹配的结果被筛选出来时，系统将使用缺省的资源目录，也就是说，缺省的资源目录必须设置，否则当系统没有匹配的资源时，程序将崩溃。

---