CameraRoll  - AS3

Determina se o aplicativo recebeu permissão para acessar as fotos da câmera.

Elementos da API relacionados

Se o método CameraRoll.addBitmapData() é suportado. Atualmente, o recurso somente possui suporte para aplicativos AIR de dispositivos móveis.

Indica se há suporte ao métodoCameraRoll.browseForImage(). Atualmente, o recurso somente possui suporte para aplicativos AIR de dispositivos móveis.

Cria um objeto CameraRoll.

Há somente uma biblioteca de mídia com suporte de ActionScript. Todos os objetos CameraRoll são salvos no mesmo repositório de imagem.

Adiciona uma imagem ao rolo da câmera do dispositivo.

Para verificar no tempo de execução se o aplicativo oferece suporte ao método CameraRoll.addBitmapData(), verifique a propriedade CameraRoll.supportsAddBitmapData.

Parâmetros

Abre uma caixa de diálogo do navegador de imagems para permitir ao usuário selecionar uma imagem existente no rolo da câmera do dispositivo.

Quando o usuário seleciona uma imagem, esta instância de CameraRoll emite um evento select que contém um objeto MediaEvent. Use a propridade data do objeto MediaEvent para carregar a imagem. A propriedade data é um objeto MediaPromise, que você pode carregar usando o método loadFilePromise() da classe Loader. Observe que o objeto MediaPromise contém um objeto de arquivo válido em algumas plataformas (Blackberry Tablet OS), mas não em outros (iOS e Android). Quando você utiliza o método loadFilePromise (), a imagem é carregada corretamente em todas as plataformas. Para acessar os dados brutos do objeto de mídia, você poderá abrir a fonte de dados fornecida pela promessa de mídia e ler os dados que utilizam os métodos da interface IDataInput.

Para verificar no tempo de execução se o aplicativo oferece suporte ao método CameraRoll.browseForImage(), verifique a propriedade CameraRoll.supportsBrowseForImage.

No iOS (e somente no iPad), você poderá pode solicitar um tamanho específico para o diálogo do navegador de imagem. Também é possível especificar uma área da tela que você não deseja que o diálogo do navegador de imagem cubra. Esta solicitação funciona somente no iPad, porque nesse dispositivo o navegador de imagem não ocupa a tela inteira.

Para solicitar tamanho e opções de posicionamento do navegador de imagem (para o iPad), transmita um objeto CameraRollBrowseOptions para browseForImage (). Sem parâmetros, este método posiciona a caixa de diálogo no canto superior esquerdo da exibição, utilizando os padrões de sistema das dimensões do diálogo.

Parâmetros

Saiba mais

Elementos da API relacionados

package flash.media.examples
{
        import flash.media.CameraRoll;
        import flash.media.MediaPromise;
        import flash.media.MediaType;
        import flash.events.MediaEvent;
        import flash.events.Event;
        import flash.display.Loader;
        import flash.display.Sprite;
        import flash.events.IOErrorEvent;
        import flash.display.StageAlign;
        import flash.display.StageScaleMode;
        
        public class CameraRollTest extends Sprite{
            private var mediaSource:CameraRoll = new CameraRoll();
            
            public function CameraRollTest() {
                this.stage.align = StageAlign.TOP_LEFT;
                this.stage.scaleMode = StageScaleMode.NO_SCALE;
                
                if( CameraRoll.supportsBrowseForImage )
                {
                    log( "Browsing for image..." );
                    mediaSource.addEventListener( MediaEvent.SELECT, imageSelected );
                    mediaSource.addEventListener( Event.CANCEL, browseCanceled );
                    
                    mediaSource.browseForImage();
                }
                else
                {
                    log( "Browsing in camera roll is not supported.");
                }
            }
            
            private var imageLoader:Loader; 
            private function imageSelected( event:MediaEvent ):void
            {
                log( "Image selected..." );
                
                var imagePromise:MediaPromise = event.data;
                
                imageLoader = new Loader();
                if( imagePromise.isAsync )
                {
                    log( "Asynchronous media promise." );
                    imageLoader.contentLoaderInfo.addEventListener( Event.COMPLETE, imageLoaded );
                    imageLoader.contentLoaderInfo.addEventListener( IOErrorEvent.IO_ERROR, imageLoadFailed );
                    imageLoader.loadFilePromise( imagePromise );
                }
                else
                {
                    log( "Synchronous media promise." );
                    imageLoader.loadFilePromise( imagePromise );
                    this.addChild( imageLoader );
                }
            }
            
            private function browseCanceled( event:Event ):void
            {
                log( "Image browse canceled." );
            }
            
            private function imageLoaded( event:Event ):void
            {
                log( "Image loaded asynchronously." );
                this.addChild( imageLoader );
            }
            
            private function imageLoadFailed( event:Event ):void
            {
                log( "Image load failed." );
            }
            
            private function log( text:String ):void
            {
                trace( text );
            }
            
        }
        
    }

Solicita permissão para acessar a biblioteca de mídia do sistema ou as "fotos da câmera".

Despachado quando o usuário cancela uma operação de procura de imagem sem selecionar uma imagem.

Esse evento tem as seguintes propriedades:

Sinaliza que a operação addBitmapData() foi concluída com êxito.

Esse evento tem as seguintes propriedades:

O evento error é despachado quando ocorre um erro.

As fontes de erros incluem:

• Não é possível abrir um navegador de imagem.
• Um navegador de imagem já está em uso.
• O aplicativo AIR tenta procurar uma imagem enquanto em segundo plano.
• Não é possível adicionar uma imagem à biblioteca de mídia.
• Um método ao qual o dispositivo não oferece suporte foi chamado.
• O aplicativo AIR tenta carregar uma imagem remota sem uma conexão com a Internet.

Esse evento tem as seguintes propriedades:

Será despachado quando o aplicativo solicitar permissão para acessar as imagens da câmera. Verifique o valor da propriedade status para determinar se a permissão for concedida ou recusada

Elementos da API relacionados

Despachado quando o usuário seleciona uma imagem da biblioteca de mídia do dispositivo.

O objeto MediaEvent despachado para este evento fornece acesso à mídia escolhida.

Define o valor da propriedade type de um objeto de evento MediaEvent. Esse evento tem as seguintes propriedades: