// ===========================================
// 文件: MainActivity.java
// 描述: 主 Activity，實現媒體輪播和視頻自動播放控制
// ===========================================
package com.example.mediacarouseldemo;
 
import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity;
import androidx.viewpager.widget.ViewPager;
import android.util.Log;
import java.util.ArrayList;
import java.util.List;
 
/**
 * MainActivity 作為輪播功能的入口，主要實現以下功能：
 * 1. 初始化 ViewPager 并加載媒體 Fragment 集合。
 * 2. 根據媒體類型控制視頻自動播放與暫停。
 * 3. 更新頁面指示器（可選）。
 */
public class MainActivity extends AppCompatActivity {
 
    private static final String TAG = "MainActivity";
    private ViewPager mViewPager;
    private MediaPagerAdapter mAdapter;
    private List<MediaItem> mMediaItemList;
 
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // 設置主布局 activity_main.xml
        setContentView(R.layout.activity_main);
 
        mViewPager = findViewById(R.id.viewpager);
 
        // 初始化媒體數據（示例中混合圖片和視頻）
        initMediaData();
 
        // 初始化適配器，將數據傳遞給 MediaPagerAdapter
        mAdapter = new MediaPagerAdapter(getSupportFragmentManager(), mMediaItemList);
        mViewPager.setAdapter(mAdapter);
 
        // 監(jiān)聽頁面切換事件，實現視頻自動播放和暫停功能
        mViewPager.addOnPageChangeListener(new ViewPager.OnPageChangeListener() {
            private int currentPage = 0;
            @Override
            public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) { }
 
            @Override
            public void onPageSelected(int position) {
                // 獲取前一個頁面并暫停視頻播放（若為 VideoFragment）
                MediaFragment previousFragment = mAdapter.getMediaFragment(currentPage);
                if (previousFragment instanceof VideoFragment) {
                    ((VideoFragment) previousFragment).pauseVideo();
                }
                // 獲取當前頁面并啟動視頻播放（若為 VideoFragment）
                MediaFragment currentFragment = mAdapter.getMediaFragment(position);
                if (currentFragment instanceof VideoFragment) {
                    ((VideoFragment) currentFragment).playVideo();
                }
                currentPage = position;
            }
 
            @Override
            public void onPageScrollStateChanged(int state) { }
        });
    }
 
    /**
     * 初始化媒體數據列表，可根據需要從網絡或本地數據庫加載數據
     */
    private void initMediaData() {
        mMediaItemList = new ArrayList<>();
        // 添加示例數據：類型 0 表示圖片，類型 1 表示視頻
        mMediaItemList.add(new MediaItem(0, "圖片1", "drawable://sample_image1"));
        mMediaItemList.add(new MediaItem(1, "視頻1", "video://sample_video1.mp4"));
        mMediaItemList.add(new MediaItem(0, "圖片2", "drawable://sample_image2"));
        mMediaItemList.add(new MediaItem(1, "視頻2", "video://sample_video2.mp4"));
        mMediaItemList.add(new MediaItem(0, "圖片3", "drawable://sample_image3"));
    }
 
    @Override
    protected void onPause() {
        super.onPause();
        // 當 Activity 暫停時，確保當前視頻停止播放
        int currentItem = mViewPager.getCurrentItem();
        MediaFragment currentFragment = mAdapter.getMediaFragment(currentItem);
        if (currentFragment instanceof VideoFragment) {
            ((VideoFragment) currentFragment).pauseVideo();
        }
    }
}
 
// ===========================================
// 文件: MediaItem.java
// 描述: 數據模型類，用于表示媒體項（圖片或視頻）信息
// ===========================================
package com.example.mediacarouseldemo;
 
/**
 * MediaItem 包含媒體類型、標題和資源地址
 * mediaType: 0 表示圖片，1 表示視頻
 */
public class MediaItem {
    private int mediaType;
    private String title;
    private String resourceUrl;
 
    public MediaItem(int mediaType, String title, String resourceUrl) {
        this.mediaType = mediaType;
        this.title = title;
        this.resourceUrl = resourceUrl;
    }
 
    public int getMediaType() {
        return mediaType;
    }
 
    public String getTitle() {
        return title;
    }
 
    public String getResourceUrl() {
        return resourceUrl;
    }
}
 
// ===========================================
// 文件: MediaFragment.java
// 描述: 抽象父 Fragment，用于統(tǒng)一圖片和視頻頁面的基礎邏輯
// ===========================================
package com.example.mediacarouseldemo;
 
import androidx.fragment.app.Fragment;
 
/**
 * MediaFragment 為展示媒體內容的基類，ImageFragment 與 VideoFragment 均繼承自此類
 */
public abstract class MediaFragment extends Fragment {
    // 定義公共方法接口，如播放、暫停等，由具體子類實現
}
 
// ===========================================
// 文件: ImageFragment.java
// 描述: 顯示圖片的 Fragment，通過 ImageView 展示圖片資源
// ===========================================
package com.example.mediacarouseldemo;
 
import android.os.Bundle;
import androidx.annotation.Nullable;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.ImageView;
import com.bumptech.glide.Glide;
 
/**
 * ImageFragment 繼承自 MediaFragment，用于加載和展示圖片
 */
public class ImageFragment extends MediaFragment {
 
    private static final String ARG_TITLE = "arg_title";
    private static final String ARG_RESOURCE_URL = "arg_resource_url";
    private String mTitle;
    private String mResourceUrl;
 
    public static ImageFragment newInstance(String title, String resourceUrl) {
        ImageFragment fragment = new ImageFragment();
        Bundle args = new Bundle();
        args.putString(ARG_TITLE, title);
        args.putString(ARG_RESOURCE_URL, resourceUrl);
        fragment.setArguments(args);
        return fragment;
    }
 
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        if (getArguments() != null) {
            mTitle = getArguments().getString(ARG_TITLE);
            mResourceUrl = getArguments().getString(ARG_RESOURCE_URL);
        }
    }
 
    @Nullable
    @Override
    public View onCreateView(LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
        // 加載布局文件 fragment_image.xml
        View view = inflater.inflate(R.layout.fragment_image, container, false);
        ImageView imageView = view.findViewById(R.id.iv_image);
        // 加載圖片資源，使用 Glide 庫進行圖片加載（可根據需求選擇其他圖片加載庫）
        Glide.with(getContext()).load(mResourceUrl).into(imageView);
        return view;
    }
}
 
// ===========================================
// 文件: VideoFragment.java
// 描述: 顯示視頻的 Fragment，通過 VideoView 實現視頻播放
// ===========================================
package com.example.mediacarouseldemo;
 
import android.net.Uri;
import android.os.Bundle;
import androidx.annotation.Nullable;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.VideoView;
 
/**
 * VideoFragment 繼承自 MediaFragment，用于加載和播放視頻
 */
public class VideoFragment extends MediaFragment {
 
    private static final String ARG_TITLE = "arg_title";
    private static final String ARG_RESOURCE_URL = "arg_resource_url";
    private String mTitle;
    private String mResourceUrl;
    private VideoView mVideoView;
 
    public static VideoFragment newInstance(String title, String resourceUrl) {
        VideoFragment fragment = new VideoFragment();
        Bundle args = new Bundle();
        args.putString(ARG_TITLE, title);
        args.putString(ARG_RESOURCE_URL, resourceUrl);
        fragment.setArguments(args);
        return fragment;
    }
 
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        if(getArguments() != null) {
            mTitle = getArguments().getString(ARG_TITLE);
            mResourceUrl = getArguments().getString(ARG_RESOURCE_URL);
        }
    }
 
    @Nullable
    @Override
    public View onCreateView(LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
        // 加載布局文件 fragment_video.xml
        View view = inflater.inflate(R.layout.fragment_video, container, false);
        mVideoView = view.findViewById(R.id.video_view);
        // 設置視頻 URI（本示例使用本地文件或網絡視頻）
        mVideoView.setVideoURI(Uri.parse(mResourceUrl));
        return view;
    }
 
    /**
     * 開始播放視頻
     */
    public void playVideo() {
        if(mVideoView != null && !mVideoView.isPlaying()) {
            mVideoView.start();
        }
    }
 
    /**
     * 暫停視頻播放
     */
    public void pauseVideo() {
        if(mVideoView != null && mVideoView.isPlaying()) {
            mVideoView.pause();
        }
    }
}
 
// ===========================================
// 文件: MediaPagerAdapter.java
// 描述: ViewPager 適配器，負責將圖片或視頻 Fragment 動態(tài)加載到 ViewPager 中
// ===========================================
package com.example.mediacarouseldemo;
 
import androidx.fragment.app.Fragment;
import androidx.fragment.app.FragmentManager;
import androidx.fragment.app.FragmentPagerAdapter;
import java.util.List;
 
/**
 * MediaPagerAdapter 繼承自 FragmentPagerAdapter，用于管理媒體 Fragment 的加載
 */
public class MediaPagerAdapter extends FragmentPagerAdapter {
 
    private List<MediaItem> mMediaItems;
    // 為了便于在 Activity 中獲取對應 Fragment，使用數組記錄已創(chuàng)建的 Fragment
    private MediaFragment[] mFragments;
 
    public MediaPagerAdapter(FragmentManager fm, List<MediaItem> items) {
        super(fm, BEHAVIOR_RESUME_ONLY_CURRENT_FRAGMENT);
        mMediaItems = items;
        mFragments = new MediaFragment[items.size()];
    }
 
    @Override
    public Fragment getItem(int position) {
        MediaItem item = mMediaItems.get(position);
        MediaFragment fragment;
        if(item.getMediaType() == 0) {
            // 圖片類型，返回 ImageFragment
            fragment = ImageFragment.newInstance(item.getTitle(), item.getResourceUrl());
        } else {
            // 視頻類型，返回 VideoFragment
            fragment = VideoFragment.newInstance(item.getTitle(), item.getResourceUrl());
        }
        mFragments[position] = fragment;
        return fragment;
    }
 
    @Override
    public int getCount() {
        return mMediaItems.size();
    }
 
    /**
     * 提供外部接口，返回指定位置的 MediaFragment 用于視頻播放控制
     */
    public MediaFragment getMediaFragment(int position) {
        if(position < mFragments.length) {
            return mFragments[position];
        }
        return null;
    }
}

<!-- ===========================================
     文件: activity_main.xml
     描述: MainActivity 的布局文件，包含 ViewPager 用于展示圖片和視頻輪播效果
     =========================================== -->
<?xml version="1.0" encoding="utf-8"?>
<androidx.coordinatorlayout.widget.CoordinatorLayout 
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/main_coordinator"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
 
    <!-- Toolbar 用于展示頂部標題，非必需，可根據需求添加 -->
    <com.google.android.material.appbar.AppBarLayout
        android:id="@+id/appbar"
        android:layout_width="match_parent"
        android:layout_height="wrap_content">
        <androidx.appcompat.widget.Toolbar
            android:id="@+id/toolbar"
            android:layout_width="match_parent"
            android:layout_height="?attr/actionBarSize"
            app:title="媒體輪播"
            app:titleTextColor="@android:color/white"
            app:popupTheme="@style/ThemeOverlay.AppCompat.Light"/>
    </com.google.android.material.appbar.AppBarLayout>
 
    <!-- ViewPager 占據剩余空間 -->
    <androidx.viewpager.widget.ViewPager
        android:id="@+id/viewpager"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:layout_behavior="@string/appbar_scrolling_view_behavior"/>
</androidx.coordinatorlayout.widget.CoordinatorLayout>
 
<!-- ===========================================
     文件: fragment_image.xml
     描述: ImageFragment 布局文件，僅包含一個 ImageView 用于展示圖片
     =========================================== -->
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout 
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/image_fragment_root"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="#000000">
 
    <ImageView
        android:id="@+id/iv_image"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:scaleType="centerCrop"/>
</RelativeLayout>
 
<!-- ===========================================
     文件: fragment_video.xml
     描述: VideoFragment 布局文件，僅包含一個 VideoView 用于播放視頻
     =========================================== -->
<?xml version="1.0" encoding="utf-8"?>
<FrameLayout 
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/video_fragment_root"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="#000000">
 
    <VideoView
        android:id="@+id/video_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>
</FrameLayout>
 
<!-- ===========================================
     文件: colors.xml
     描述: 定義項目中使用的顏色資源
     =========================================== -->
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <color name="white">#FFFFFF</color>
    <color name="black">#000000</color>
    <color name="primary">#3F51B5</color>
</resources>
 
<!-- ===========================================
     文件: styles.xml
     描述: 定義應用主題與樣式資源，采用 AppCompat 主題
     =========================================== -->
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar">
        <item name="android:windowBackground">@color/black</item>
        <item name="android:textColorPrimary">@color/white</item>
    </style>
</resources>