20cb94eeb5
MediaPlayer.java has 3 new methods: * newRequest creates a Parcel that can be used to send data to the native player using invoke. * invoke issues synchronous calls to the native player using opaque parcels for the request and reply. IMediaPlayer.h has 1 new abstract method: * invoke The Midi and Vorbis players have a stub for these. So far only PV makes use of that new feature. To avoid any copy overhead, the JNI interface uses Parcel as a java object (no serialization/copy happens at the JNI layer). The remote interface token is inserted when the Parcel is constructed in java. That way the parcel is already routable when it reaches IMediaPlayer.cpp (proxy). No extra copy is needed there.
135 lines
5.0 KiB
C++
135 lines
5.0 KiB
C++
/*
|
|
* Copyright (C) 2007 The Android Open Source Project
|
|
*
|
|
* 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.
|
|
*/
|
|
|
|
#ifndef ANDROID_MEDIAPLAYERINTERFACE_H
|
|
#define ANDROID_MEDIAPLAYERINTERFACE_H
|
|
|
|
#ifdef __cplusplus
|
|
|
|
#include <ui/ISurface.h>
|
|
#include <utils/RefBase.h>
|
|
|
|
#include <media/mediaplayer.h>
|
|
#include <media/AudioSystem.h>
|
|
|
|
namespace android {
|
|
|
|
class Parcel;
|
|
|
|
enum player_type {
|
|
PV_PLAYER = 1,
|
|
SONIVOX_PLAYER = 2,
|
|
VORBIS_PLAYER = 3
|
|
};
|
|
|
|
|
|
#define DEFAULT_AUDIOSINK_BUFFERCOUNT 4
|
|
#define DEFAULT_AUDIOSINK_BUFFERSIZE 1200
|
|
#define DEFAULT_AUDIOSINK_SAMPLERATE 44100
|
|
|
|
|
|
// callback mechanism for passing messages to MediaPlayer object
|
|
typedef void (*notify_callback_f)(void* cookie, int msg, int ext1, int ext2);
|
|
|
|
// abstract base class - use MediaPlayerInterface
|
|
class MediaPlayerBase : public RefBase
|
|
{
|
|
public:
|
|
// AudioSink: abstraction layer for audio output
|
|
class AudioSink : public RefBase {
|
|
public:
|
|
virtual ~AudioSink() {}
|
|
virtual bool ready() const = 0; // audio output is open and ready
|
|
virtual bool realtime() const = 0; // audio output is real-time output
|
|
virtual ssize_t bufferSize() const = 0;
|
|
virtual ssize_t frameCount() const = 0;
|
|
virtual ssize_t channelCount() const = 0;
|
|
virtual ssize_t frameSize() const = 0;
|
|
virtual uint32_t latency() const = 0;
|
|
virtual float msecsPerFrame() const = 0;
|
|
virtual status_t open(uint32_t sampleRate, int channelCount, int format=AudioSystem::PCM_16_BIT, int bufferCount=DEFAULT_AUDIOSINK_BUFFERCOUNT) = 0;
|
|
virtual void start() = 0;
|
|
virtual ssize_t write(const void* buffer, size_t size) = 0;
|
|
virtual void stop() = 0;
|
|
virtual void flush() = 0;
|
|
virtual void pause() = 0;
|
|
virtual void close() = 0;
|
|
};
|
|
|
|
MediaPlayerBase() : mCookie(0), mNotify(0) {}
|
|
virtual ~MediaPlayerBase() {}
|
|
virtual status_t initCheck() = 0;
|
|
virtual bool hardwareOutput() = 0;
|
|
virtual status_t setDataSource(const char *url) = 0;
|
|
virtual status_t setDataSource(int fd, int64_t offset, int64_t length) = 0;
|
|
virtual status_t setVideoSurface(const sp<ISurface>& surface) = 0;
|
|
virtual status_t prepare() = 0;
|
|
virtual status_t prepareAsync() = 0;
|
|
virtual status_t start() = 0;
|
|
virtual status_t stop() = 0;
|
|
virtual status_t pause() = 0;
|
|
virtual bool isPlaying() = 0;
|
|
virtual status_t seekTo(int msec) = 0;
|
|
virtual status_t getCurrentPosition(int *msec) = 0;
|
|
virtual status_t getDuration(int *msec) = 0;
|
|
virtual status_t reset() = 0;
|
|
virtual status_t setLooping(int loop) = 0;
|
|
virtual player_type playerType() = 0;
|
|
virtual void setNotifyCallback(void* cookie, notify_callback_f notifyFunc) {
|
|
mCookie = cookie; mNotify = notifyFunc; }
|
|
// Invoke a generic method on the player by using opaque parcels
|
|
// for the request and reply.
|
|
// @param request Parcel that is positioned at the start of the
|
|
// data sent by the java layer.
|
|
// @param[out] reply Parcel to hold the reply data. Cannot be null.
|
|
// @return OK if the invocation was made successfully. A player
|
|
// not supporting the direct API should return INVALID_OPERATION.
|
|
virtual status_t invoke(const Parcel& request, Parcel *reply) = 0;
|
|
protected:
|
|
virtual void sendEvent(int msg, int ext1=0, int ext2=0) { if (mNotify) mNotify(mCookie, msg, ext1, ext2); }
|
|
|
|
void* mCookie;
|
|
notify_callback_f mNotify;
|
|
};
|
|
|
|
// Implement this class for media players that use the AudioFlinger software mixer
|
|
class MediaPlayerInterface : public MediaPlayerBase
|
|
{
|
|
public:
|
|
virtual ~MediaPlayerInterface() { }
|
|
virtual bool hardwareOutput() { return false; }
|
|
virtual void setAudioSink(const sp<AudioSink>& audioSink) { mAudioSink = audioSink; }
|
|
protected:
|
|
sp<AudioSink> mAudioSink;
|
|
};
|
|
|
|
// Implement this class for media players that output directo to hardware
|
|
class MediaPlayerHWInterface : public MediaPlayerBase
|
|
{
|
|
public:
|
|
virtual ~MediaPlayerHWInterface() {}
|
|
virtual bool hardwareOutput() { return true; }
|
|
virtual status_t setVolume(float leftVolume, float rightVolume) = 0;
|
|
virtual status_t setAudioStreamType(int streamType) = 0;
|
|
};
|
|
|
|
}; // namespace android
|
|
|
|
#endif // __cplusplus
|
|
|
|
|
|
#endif // ANDROID_MEDIAPLAYERINTERFACE_H
|