/MediaPicker

Easy customizable picker for all your needs in Android application

Primary LanguageKotlinApache License 2.0Apache-2.0

Universal Media Picker

Easy customizable picker for all your needs in Android application

Android ArsenalAPI Download

Setup

Gradle:

Add following line of code to your module(app) level gradle file

    implementation 'com.robertlevonyan.components:Picker:1.0.5'

Maven:

  <dependency>
    <groupId>com.robertlevonyan.components</groupId>
    <artifactId>Picker</artifactId>
    <version>1.0.5</version>
    <type>pom</type>
  </dependency>

Usage

Buildung picker

  val pickerDialog = PickerDialog.Builder(this)// Activity or Fragment
                       .setTitle(...)          // String value or resource ID
                       .setTitleTextSize(...)  // Text size of title
                       .setTitleTextColor(...) // Color of title text
                       .setListType(...)       // Type of the picker, must be PickerDialog.TYPE_LIST or PickerDialog.TYPE_Grid
                       .setItems(...)          // List of ItemModel-s which should be in picker
                       .create()               // Create picker

Creating items

  /*  Create a camera item, can be
      ItemModel.ITEM_CAMERA 
      ItemModel.ITEM_GALLERY
      ItemModel.ITEM_VIDEO
      ItemModel.ITEM_VIDEO_GALLERY 
      ItemModel.ITEM_FILES 
  */
  val itemModel = ItemModel(ItemModel.ITEM_CAMERA)
  
  // Some optional parameters
  val itemModel = ItemModel(
                    ItemModel.ITEM_CAMERA,
                    itemLabel, // Default value is "", in this case default text value will be set
                    itemIcon,  // Default value is 0, in this case default icon will be set
                    hasBackground, // draw a shape background over the icon, default value is true
                    backgroundType, // choose a type for icon background, only works if hasBackground is true, can have one of
                                    // this values: ItemType.TYPE_CIRCLE, ItemType.TYPE_SQUARE, ItemType.TYPE_ROUNDED_SQUARE
                    itemBackgroundColor, // custom color for background shape, only works if hasBackground is true, 
                                         // default color is accent color of your app
                    )

Passing permissions from Activity

    override fun onRequestPermissionsResult(requestCode: Int, permissions: Array<out String>, grantResults: IntArray) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults)
        pickerDialog.onPermissionsResult(requestCode, permissions, grantResults)
    }
    
    // or if you have a fragment
    override fun onRequestPermissionsResult(requestCode: Int, permissions: Array<out String>, grantResults: IntArray) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults)
        myFragment.pickerDialog.onPermissionsResult(requestCode, permissions, grantResults)
    }

Showing picker

  pickerDialog.show()

And the result is

List picker Grid picker

Getting the result

    pickerDialog.setPickerCloseListener { type, uri ->
        when (type) {
            ItemModel.ITEM_CAMERA -> /* do something with the photo you've taken */
            ItemModel.ITEM_GALLERY -> /* do something with the image you've chosen */
            ItemModel.ITEM_VIDEO -> /* do something with the video you've recorded */
            ItemModel.ITEM_VIDEO_GALLERY -> /* do something with the video you've chosen */
            ItemModel.ITEM_FILES -> /* do something with the file you've chosen */
        }
     }

Versions

1.0.0 - 1.0.5

First version of library

Contact

Licence

    Universal Media Picker©
    Copyright 2018 Robert Levonyan
    Url: https://github.com/robertlevonyan/MediaPicker

    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.