代码拉取完成，页面将自动刷新
Album is a Material Design style album, it provides three functions: album, camera and gallery.
White StatusBar, the left is the effect of 5.0-(Containing 5.0), the right is the effect of 6.0+(Containing 6.0):
Effect on landscape screen:
implementation 'com.yanzhenjie:album:2.1.3'
Developers must configure AlbumLoader to make Album work normally, and AlbumLoader is used to load thumbnails of images and videos.
This is an example:
public class MediaLoader implements AlbumLoader {
@Override
public void load(ImageView imageView, AlbumFile albumFile) {
load(imageView, albumFile.getPath());
}
@Override
public void load(ImageView imageView, String url) {
Glide.with(imageView.getContext())
.load(url)
.error(R.drawable.placeholder)
.placeholder(R.drawable.placeholder)
.crossFade()
.into(imageView);
}
}
The example uses Glide to load thumbnails of pictures and videos. Please remember to configure the AlbumLoader you just implemented.
Album.initialize(AlbumConfig.newBuilder(this)
.setAlbumLoader(new MediaLoader())
...
.build());
Album.album(this) // Image and video mix options.
.multipleChoice() // Multi-Mode, Single-Mode: singleChoice().
.columnCount() // The number of columns in the page list.
.selectCount() // Choose up to a few images.
.camera() // Whether the camera appears in the Item.
.cameraVideoQuality(1) // Video quality, [0, 1].
.cameraVideoLimitDuration(Long.MAX_VALUE) // The longest duration of the video is in milliseconds.
.cameraVideoLimitBytes()(Long.MAX_VALUE) // Maximum size of the video, in bytes.
.checkedList() // To reverse the list.
.filterSize() // Filter the file size.
.filterMimeType() // Filter file format.
.filterDuration() // Filter video duration.
.afterFilterVisibility() // Show the filtered files, but they are not available.
.onResult(new Action<ArrayList<AlbumFile>>() {
@Override
public void onAction(@NonNull ArrayList<AlbumFile> result) {
// TODO accept the result.
}
})
.onCancel(new Action<String>() {
@Override
public void onAction(@NonNull String result) {
// The user canceled the operation.
}
})
.start();
Album.image(this) // Image selection.
.multipleChoice()
.camera()
.columnCount()
.selectCount()
.checkedList(mAlbumFiles)
.filterSize() // Filter the file size.
.filterMimeType() // Filter file format.
.afterFilterVisibility() // Show the filtered files, but they are not available.
.onResult(new Action<ArrayList<AlbumFile>>() {
@Override
public void onAction(@NonNull ArrayList<AlbumFile> result) {
}
})
.onCancel(new Action<String>() {
@Override
public void onAction(@NonNull String result) {
}
})
.start();
If developer want to crop the image, please use Durban.
Album.video(this) // Video selection.
.multipleChoice()
.camera(true)
.columnCount(2)
.selectCount(6)
.checkedList(mAlbumFiles)
.filterSize()
.filterMimeType()
.filterDuration()
.afterFilterVisibility() // Show the filtered files, but they are not available.
.onResult(new Action<ArrayList<AlbumFile>>() {
@Override
public void onAction(@NonNull ArrayList<AlbumFile> result) {
}
})
.onCancel(new Action<String>() {
@Override
public void onAction(@NonNull String result) {
}
})
.start();
Album.camera(this) // Camera function.
.image() // Take Picture.
.filePath() // File save path, not required.
.onResult(new Action<String>() {
@Override
public void onAction(@NonNull String result) {
}
})
.onCancel(new Action<String>() {
@Override
public void onAction(@NonNull String result) {
}
})
.start();
If developer want to crop the image, please use Durban.
Album.camera(this)
.video() // Record Video.
.filePath()
.quality(1) // Video quality, [0, 1].
.limitDuration(Long.MAX_VALUE) // The longest duration of the video is in milliseconds.
.limitBytes(Long.MAX_VALUE) // Maximum size of the video, in bytes.
.onResult(new Action<String>() {
@Override
public void onAction(@NonNull String result) {
}
})
.onCancel(new Action<String>() {
@Override
public void onAction(@NonNull String result) {
}
})
.start();
// Preview AlbumFile:
Album.galleryAlbum(this)
...
// Preview path:
Album.gallery(this)
.checkedList(imageList) // List of image to view: ArrayList<String>.
.checkable(true) // Whether there is a selection function.
.onResult(new Action<ArrayList<String>>() { // If checkable(false), action not required.
@Override
public void onAction(@NonNull ArrayList<String> result) {
}
})
.onCancel(new Action<String>() {
@Override
public void onAction(@NonNull String result) {
}
})
.start();
If
checkable(false), listener not required, theCheckBoxand theFinishButtonwill be not appear.
The user may click or long press on the preview image and the developer can listen to both events:
Album.gallery(this)
...
.itemClick(new ItemAction<String>() {
@Override
public void onAction(Context context, String item) {
}
})
.itemLongClick(new ItemAction<String>() {
@Override
public void onAction(Context context, String item) {
}
})
.start();
AlbumFile is the result of the selection of images and videos, The properties of the image and video are different, and their different attributes are listed below.
public int getMediaType(); // File type, the image is AlbumFile.TYPE_IMAGE.
public String getPath(); // File path, must not be empty.
public String getBucketName(); // The name of the folder where the file is located.
public String getMimeType(); // File MimeType, for example: image/jpeg.
public long getAddDate(); // File to add date, must have.
public float getLatitude(); // The latitude of the file, may be zero.
public float getLongitude(); // The longitude of the file, may be zero.
public long getSize(); // File size in bytes.
public String getThumbPath(); // This is a small thumbnail.
public int getMediaType(); // File type, the video is AlbumFile.TYPE_VIDEO.
public String getPath(); // File path, must not be empty.
public String getBucketName(); // The name of the folder where the file is located.
public String getMimeType(); // File MimeType, for example: image/jpeg.
public long getAddDate(); // File to add date, must have.
public float getLatitude(); // The latitude of the file, may be zero.
public float getLongitude(); // The longitude of the file, may be zero.
public long getSize(); // File size in bytes.
public long getDuration(); // Video duration, must have.
public String getThumbPath(); // This is a small thumbnail.
Through Widget, developer can configure the title, color of StatusBar, color of NavigationBar and so on.
// Such as image video mix:
Album.album(this)
.multipleChoice()
.widget(...)
...
// Image selection:
Album.image(this)
.multipleChoice()
.widget(...)
...
// Video selection:
Album.video(this)
.multipleChoice()
.widget(...)
...
// Gallery, preview AlbumFile:
Album.galleryAlbum(this)
.widget(...)
...
// Gallery, preview path:
Album.gallery(this)
.widget(...)
...
So we only need to pass in a Widget parameter just fine:
// StatusBar is a dark background when building:
Widget.newDarkBuilder(this)
...
// StatusBar is a light background when building:
Widget.newLightBuilder(this)
...
// Such as:
Widget.xxxBuilder(this)
.title(...) // Title.
.statusBarColor(Color.WHITE) // StatusBar color.
.toolBarColor(Color.WHITE) // Toolbar color.
.navigationBarColor(Color.WHITE) // Virtual NavigationBar color of Android5.0+.
.mediaItemCheckSelector(Color.BLUE, Color.GREEN) // Image or video selection box.
.bucketItemCheckSelector(Color.RED, Color.YELLOW) // Select the folder selection box.
.buttonStyle( // Used to configure the style of button when the image/video is not found.
Widget.ButtonStyle.newLightBuilder(this) // With Widget's Builder model.
.setButtonSelector(Color.WHITE, Color.WHITE) // Button selector.
.build()
)
.build()
Album defaults to English and changes with the system language. Unfortunately, Album only supports English, Simplified Chinese, Traditional Chinese and Portuguese. However, developers can copy the items in Album's string.xml into your project for translation, the best thing is that you can contribute and submit pull requests to perfect Album.
Developers can specify Album's language:
Album.initialize(AlbumConfig.newBuilder(this)
...
.setLocale(Locale.ENGLISH)
.build());
Before submitting pull requests, contributors must abide by the agreement .
If you are using ProGuard you might need to add the following options:
-dontwarn com.yanzhenjie.album.**
-dontwarn com.yanzhenjie.mediascanner.**
Copyright 2017 Yan Zhenjie
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
此处可能存在不合适展示的内容，页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容，可点击提交进行申诉，我们将尽快为您处理。