Android获取相册列表名称

原创

mob64ca12db7156 2024-08-01 05:01:49 ©著作权

©著作权归作者所有：来自51CTO博客作者mob64ca12db7156的原创作品，请联系作者获取转载授权，否则将追究法律责任

Android获取相册列表名称的实现方法

在Android开发中，获取相册列表名称是常见的功能之一。这篇文章将带你一步一步地了解如何实现这一功能，适合刚入行的小白。

整体流程

在实现获取相册列表名称的功能时，我们可以将整个过程分为以下几个步骤。下面是一个简单的流程表格。

步骤	描述
1	添加所需的权限
2	获取相册的信息
3	显示相册名称
4	测试和调试

步骤详解

1. 添加所需的权限

在获取相册信息之前，我们需要在AndroidManifest.xml文件中添加必要的权限，以便访问媒体文件。请确保添加如下权限：

<manifest xmlns:android="
    package="com.example.albumlist">

    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
    
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/Theme.AppCompat.NoActionBar">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN"/>
                <category android:name="android.intent.category.LAUNCHER"/>
            </intent-filter>
        </activity>
    </application>
</manifest>

注释：

READ_EXTERNAL_STORAGE权限是用来读取外部存储中的相册数据。

2. 获取相册的信息

接下来，我们需要在主活动（MainActivity.java）中编写代码以获取相册列表的信息。我们将使用ContentResolver来查询相册照片。

import android.Manifest;
import android.content.ContentResolver;
import android.database.Cursor;
import android.provider.MediaStore;
import android.widget.Toast;

import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;

import java.util.ArrayList;

public class MainActivity extends AppCompatActivity {

    private ArrayList<String> albumList; // 用来存储相册名称

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        
        // 初始化相册列表
        albumList = new ArrayList<>();

        // 检查权限并获取相册信息
        if (checkSelfPermission(Manifest.permission.READ_EXTERNAL_STORAGE) == PackageManager.PERMISSION_GRANTED) {
            getAlbumNames();
        } else {
            requestPermissions(new String[]{Manifest.permission.READ_EXTERNAL_STORAGE}, 1);
        }
    }

    // 获取相册名称
    private void getAlbumNames() {
        ContentResolver contentResolver = getContentResolver();
        String[] projection = {MediaStore.Images.Media.BUCKET_DISPLAY_NAME};
        Cursor cursor = contentResolver.query(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, projection, null, null, null);

        if (cursor != null) {
            while (cursor.moveToNext()) {
                String albumName = cursor.getString(cursor.getColumnIndex(MediaStore.Images.Media.BUCKET_DISPLAY_NAME));
                if (!albumList.contains(albumName)) {
                    albumList.add(albumName);
                }
            }
            cursor.close();
        }

        // 显示相册名称
        for (String name : albumList) {
            Toast.makeText(this, name, Toast.LENGTH_SHORT).show();
        }
    }

    // 请求权限的结果
    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        if (requestCode == 1 && grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            getAlbumNames(); // 如果权限被授予，获取相册
        }
    }
}

注释：

ContentResolver允许我们对应用程序的数据进行读取。我们使用query方法访问相册的信息。
MediaStore.Images.Media.BUCKET_DISPLAY_NAME代表相册的名称。
Toast用于在屏幕上显示相册名称。

3. 显示相册名称

在上述代码中，通过Toast的方式让用户可以看到获取到的相册名称。当然，你也可以将其展示在ListView或RecyclerView中，以提供更好的用户体验。

4. 测试和调试

最后一步是对应用进行全面的测试，确保在请求权限被拒绝时能够正确处理，以及验证相册名称能否正确显示。

类图

以下是类图，描述了MainActivity的结构：

classDiagram
    class MainActivity {
        +ArrayList~String~ albumList
        +onCreate(Bundle savedInstanceState)
        +getAlbumNames()
        +onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults)
    }

状态图

这里是状态图，描述了应用的状态变化：

stateDiagram
    [*] --> CheckPermissions
    CheckPermissions --> GettingAlbums : Permission Granted
    CheckPermissions --> [*] : Permission Denied
    GettingAlbums --> ShowAlbums
    ShowAlbums --> [*]