# Package com.codename1.media

package com.codename1.media

Video and Audio playback support are handled within this package using the `com.codename1.media.Media` & `com.codename1.media.MediaManager` APIs. Said API's allow for video playback both within a native full screen player and embedded within an application screen.

Simplified video playback API is also available via the `com.codename1.components.MediaPlayer` class. Capture/recording is handled separately for the most part thru the `com.codename1.capture.Capture` API. However, there is some basic low level recording functionality within `com.codename1.media.MediaManager` as well.

The code below demonstrates capturing and playing back audio files using this API:

    Form hi = new Form("Capture", BoxLayout.y());
    hi.setToolbar(new Toolbar());
    Style s = UIManager.getInstance().getComponentStyle("Title");
    FontImage icon = FontImage.createMaterial(FontImage.MATERIAL_MIC, s);

    FileSystemStorage fs = FileSystemStorage.getInstance();
    String recordingsDir = fs.getAppHomePath() + "recordings/";
    fs.mkdir(recordingsDir);
    try {
        for(String file : fs.listFiles(recordingsDir)) {
            MultiButton mb = new MultiButton(file.substring(file.lastIndexOf("/") + 1));
            mb.addActionListener((e) -> {
                try {
                    Media m = MediaManager.createMedia(recordingsDir + file, false);
                    m.play();
                } catch(IOException err) {
                    Log.e(err);
                }
            });
            hi.add(mb);
        }

        hi.getToolbar().addCommandToRightBar("", icon, (ev) -> {
            try {
                String file = Capture.captureAudio();
                if(file != null) {
                    SimpleDateFormat sd = new SimpleDateFormat("yyyy-MMM-dd-kk-mm");
                    String fileName =sd.format(new Date());
                    String filePath = recordingsDir + fileName;
                    Util.copy(fs.openInputStream(file), fs.openOutputStream(filePath));
                    MultiButton mb = new MultiButton(fileName);
                    mb.addActionListener((e) -> {
                        try {
                            Media m = MediaManager.createMedia(filePath, false);
                            m.play();
                        } catch(IOException err) {
                            Log.e(err);
                        }
                    });
                    hi.add(mb);
                    hi.revalidate();
                }
            } catch(IOException err) {
                Log.e(err);
            }
        });
    } catch(IOException err) {
        Log.e(err);
    }
    hi.show();

The sample code below demonstrates simple video playback.

    final Form hi = new Form("MediaPlayer", new BorderLayout());
    hi.setToolbar(new Toolbar());
    Style s = UIManager.getInstance().getComponentStyle("Title");
    FontImage icon = FontImage.createMaterial(FontImage.MATERIAL_VIDEO_LIBRARY, s);
    hi.getToolbar().addCommandToRightBar(new Command("", icon) {
    @Override
        public void actionPerformed(ActionEvent evt) {
            Display.getInstance().openGallery((e) -> {
                if(e != null && e.getSource() != null) {
                    String file = (String)e.getSource();
                    try {
                        Media video = MediaManager.createMedia(file, true);
                        hi.removeAll();
                        hi.add(BorderLayout.CENTER, new MediaPlayer(video));
                        hi.revalidate();
                    } catch(IOException err) {
                        Log.e(err);
                    }
                }
            }, Display.GALLERY_VIDEO);
        }
    });
    hi.show();

- Class
  Description
  AbstractMedia
  An abstract base class for AsyncMedia.
  AsyncMedia
  An interface for media elements that provides asynchronous pause and play functionality as well as support for state change events, so that interested parties can register to be notified when state changes between play and pause.
  AsyncMedia.MediaErrorEvent
  Encapsulates a media error event.
  AsyncMedia.MediaErrorType
  Enum encapsulating the different types of media errors that can occur.
  AsyncMedia.MediaException
  Encapsulates a media exception.
  AsyncMedia.MediaStateChangeEvent
  Encapsulates a state-change event on a Media object.
  AsyncMedia.PauseRequest
  An async resource used to track the progress of a pauseAsync() request.
  AsyncMedia.PlayRequest
  An async resource used to track the progress of a playAsync() request.
  AsyncMedia.State
  An enum to represent the state of a media object.
  AudioBuffer
  This class can be used to capture raw PCM data from the device's microphone.
  AudioBuffer.AudioBufferCallback
  A callback that can be registered to receive notifications when the contents of the AudioBuffer is changed.
  AudioEffects
  Small PCM effects that operate on `AudioBuffer` data.
  AudioMixer
  Mixes multiple PCM tracks into a single `AudioBuffer`.
  CompletionAwareSoundPoolPeer
  An optional capability a `SoundPoolPeer` may implement to report when its voices finish playing.
  Media
  Media control interface allows for media playback, recording.
  MediaManager
  Allow us to create `Media` objects using String URI's or with a stream to the media data.
  MediaMetaData
  MetaData for use by `RemoteControlListener` to provide information about the currently playing background media on the device's lock screen.
  MediaRecorderBuilder
  A builder class to generate a Media recorder with specific settings.
  RecognitionCallback
  Listener for `SpeechRecognizer` results.
  RecognitionCallback.Adapter
  No-op adapter.
  RecognitionOptions
  Tuning knobs for `SpeechRecognizer`.
  RemoteControlListener
  A base class that is meant to be overridden to implement functionality that responds to the device's remote control for media playback.
  SoundPoolPeer
  Low level service provider interface backing `com.codename1.gaming.SoundPool`.
  SpeechRecognizer
  On-device speech-to-text.
  TextToSpeech
  Speaks text aloud using the platform's built-in synthesizer.
  TimedRecognitionCallback
  Caption-aware `SpeechRecognizer` callback.
  TimedRecognitionCallback.Adapter
  No-op adapter.
  Transcriber
  Provider-pluggable file transcriber.
  TranscriptionRequest
  File transcription request shared by transcription providers.
  TranscriptionResult
  A complete transcription: plain text plus the timed segments needed for captions.
  TranscriptionSegment
  One timed transcript span.
  TtsOptions
  Tuning knobs for `TextToSpeech.speak(String, TtsOptions)`.
  VideoCodec
  Describes a single codec made available by the underlying platform, as returned by `VideoIO#getAvailableEncoders()` and `VideoIO#getAvailableDecoders()`.
  VideoFrame
  A single decoded video frame produced by a `VideoReader`.
  VideoIO
  Low level video encoding and decoding using the platform's native codecs.
  VideoReader
  Decodes an existing video clip into individual RGBA frames and PCM audio.
  VideoReader.FrameCallback
  Callback used by `VideoReader#readFrames(float, FrameCallback)` to receive frames as they are decoded.
  VideoWriter
  Encodes application supplied frames and audio into a video file using the platform's native codecs.
  VideoWriterBuilder
  A fluent builder describing how a video file should be encoded.
  VoiceCompletionListener
  Low-level callback a `SoundPoolPeer` fires when one of its voices finishes.
  WAVWriter
  A class that can write raw PCM data to a WAV file.