media.selectPhoto()

General

This API is not supported on Windows Desktop.

iOS

• On iOS, in order to use the camera, you must include the following keys/descriptions in the plist table of build.settings. When the system prompts the user to allow access, the associated description is displayed as part of the alert. Note that these descriptions can be customized to your preference and they can even be localized (guide).

settings =
{
    iphone =
    {
        plist =
        {
            NSPhotoLibraryUsageDescription = "This app would like to access the photo library.",
        },
    },
}

• The iPad requires the additional parameters of origin and permittedArrowDirections to specify the location and direction of the popup used to select the photo.

listener _^(required)

Listener. Can be either a function listener or a table listener. If a table, it must have a completion method. The event dispatched to the listener will be a completion event with the following additional properties:

• event.target is a DisplayObject based on the mediaSource parameter. If the chosen image is saved to a file, there is no display object added to the stage and this value will be nil.

• event.completed will be true if the user selected a photo; false if the user cancelled the camera or photo selection.

  media.selectPhoto( { listener=sessionComplete } )

mediaSource _^(optional)

Constant. Can be one of the following:

• media.PhotoLibrary
• media.SavedPhotosAlbum

destination _^(optional)

Table. If provided, the chosen image is saved to a file. In this case, there is no DisplayObject added to the stage. This table should be in the form { [baseDir= ,] filename= }. If baseDir is specified, this is the directory constant to which to save the file.

origin _^(optional)

Table. Only applicable on iPad. Defines the bounds of the object (typically a button) from which the iPad’s popup emerges from. A convenience pattern is to pass the contentBounds property of the object.

permittedArrowDirections _^(optional)

Table. Only applicable on iPad. An array of values which defines the directions in which the iPad’s popup arrow may point. Valid values are "up", "down", "left", "right", or "any". The default is "any".

Standard

local function onComplete( event )
   local photo = event.target
   print( "photo w,h = " .. photo.width .. "," .. photo.height )
end

if media.hasSource( media.PhotoLibrary ) then
   media.selectPhoto( { mediaSource=media.PhotoLibrary, listener=onComplete } )
else
   native.showAlert( "Corona", "This device does not have a photo library.", { "OK" } )
end

iPad

-- Selection completion listener
local function onComplete( event )
    local photo = event.target
   
    if photo then
        print( "photo w,h = " .. photo.width .. "," .. photo.height )
    end
end

local button = display.newRect( 120, 240, 80, 70 )

local function pickPhoto( event )

    media.selectPhoto(
    {
        mediaSource = media.SavedPhotosAlbum,
        listener = onComplete, 
        origin = button.contentBounds, 
        permittedArrowDirections = { "right" },
        destination = { baseDir=system.TemporaryDirectory, filename="image.jpg" } 
    })
end

button:addEventListener( "tap", pickPhoto )