- Notifications
You must be signed in to change notification settings - Fork387
Android multi-media selector based on MVP mode.
License
bilibili/boxing
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
Android multi-media selector based on MVP mode.中文文档
- Custom UI
- Multiple/single selection, preview and crop function
- Gif support
- Video selection
- Image compression
- Gif encode(checkout feature/gif-encode to have fun), seeBilibili/BurstLinker
Core version: only contain the core function.
UI version: contain UI implements base on core version.
- Maven
Core version
<dependency> <groupId>com.bilibili</groupId> <artifactId>boxing</artifactId> <version>1.0.4</version> <type>pom</type> </dependency>
UI version
<dependency> <groupId>com.bilibili</groupId> <artifactId>boxing-impl</artifactId> <version>1.0.4</version> <type>pom</type> </dependency>
- Gradle
Core version
compile'com.bilibili:boxing:1.0.4'
UI version
compile'com.bilibili:boxing-impl:1.0.4'
- Media loading initialization(required)
BoxingMediaLoader.getInstance().init(newIBoxingMediaLoader());// a class implements IBoxingMediaLoader
- Image cropping initialization(optional)
BoxingCrop.getInstance().init(newIBoxingCrop());// a class implements IBoxingCrop
- Build BoxingConfigSpecify the mode(Mode.SINGLE_IMG, Mode.MULTI_IMG, Mode.VIDEO) with camera and gif support.
BoxingConfigconfig =newBoxingConfig(Mode);// Mode：Mode.SINGLE_IMG, Mode.MULTI_IMG, Mode.VIDEOconfig.needCamera(cameraRes).needGif().withMaxCount(9)// camera, gif support, set selected images count.withMediaPlaceHolderRes(resInt)// set the image placeholder, default 0.withAlbumPlaceHolderRes(resInt)// set the album placeholder, default 0.withVideoDurationRes(resInt)// set the video duration resource in video mode, default 0
- Get Boxing, set Intent and call start
// start thumbnails Activity, need boxing-impl.Boxing.of(config).withIntent(context,BoxingActivity.class).start(callerActivity,REQUEST_CODE);// start view raw image Activity, need boxing-impl.Boxing.of(config).withIntent(context,BoxingViewActivity.class).start(callerActivity,REQUEST_CODE);// call of() use Mode.MULTI_IMG by default.Boxing.of().withIntent(context,class).start(callerActivity,REQUEST_CODE);
- Get Result
@OverrideprotectedvoidonActivityResult(intrequestCode,intresultCode,Intentdata) {List<BaseMedia>medias =Boxing.getResult(data);// avoid null}
Media loading and image cropping initialization are the same as Simple Usage.
Customize Activity and FragmentExtends AbsBoxingViewActivity and AbsBoxingViewFragment.call
Boxing.of(config).withIntent(context, AbsBoxingViewActivity.class).start(callerActivity, REQUEST_CODE);to start.Only customize FragmentExtends AbsBoxingViewFragment,no AbsBoxingViewActivity.call
Boxing.of(BoxingConfig).setupFragment(AbsBoxingViewFragment, OnFinishListener);to start.
Use camera in Android N, add this in AndroidManifest.xml
<provider android:name="android.support.v4.content.FileProvider"android:authorities="${applicationId}.file.provider" > <meta-data android:name="android.support.FILE_PROVIDER_PATHS"android:resource="@xml/boxing_file_provider"/></provider>
Stay hungry, stay foolish.checkoutfeature/kotlin for fun.
Support different config at the same moment.
Copyright 2017 BilibiliLicensed 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 athttp://www.apache.org/licenses/LICENSE-2.0Unless 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.
About
Android multi-media selector based on MVP mode.