media.save()

Simulator

On the Corona Simulator, the files are not added to the actual user's photo library. On Mac, it is saved to the location specified in the Corona Simulator Console output.

Android

On Android, you must add the android.permission.WRITE_EXTERNAL_STORAGE permission to your project's build.settings file. Otherwise, Android will not allow your photo to be added to the photo library:

settings =
{
    android =
    {
        usesPermissions =
        {
            "android.permission.WRITE_EXTERNAL_STORAGE",
        },
    },
}

filename _^(required)

String. The name of the image file to be added to the photo library, relative to baseDirectory (or system.ResourceDirectory by default).

baseDir _^(optional)

Constant. Path to load the image data from filename. Default is system.ResourceDirectory. See system.pathForFile() for valid values).