blob: 2ef623464db22c9a8f9fdc128b24fb95c2af0801 [file] [log] [blame]
/*
* Copyright (C) 2017 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 AAUDIO_SERVICE_ENDPOINT_H
#define AAUDIO_SERVICE_ENDPOINT_H
#include <atomic>
#include <functional>
#include <mutex>
#include <vector>
#include "client/AudioStreamInternal.h"
#include "client/AudioStreamInternalPlay.h"
#include "core/AAudioStreamParameters.h"
#include "binding/AAudioServiceMessage.h"
#include "binding/AAudioStreamConfiguration.h"
#include "AAudioServiceStreamBase.h"
namespace aaudio {
/**
* AAudioServiceEndpoint is used by a subclass of AAudioServiceStreamBase
* to communicate with the underlying audio device or port.
*/
class AAudioServiceEndpoint
: public virtual android::RefBase
, public AAudioStreamParameters {
public:
virtual ~AAudioServiceEndpoint();
virtual std::string dump() const;
virtual aaudio_result_t open(const aaudio::AAudioStreamRequest &request) = 0;
virtual aaudio_result_t close() = 0;
virtual aaudio_result_t registerStream(android::sp<AAudioServiceStreamBase> stream);
virtual aaudio_result_t unregisterStream(android::sp<AAudioServiceStreamBase> stream);
virtual aaudio_result_t startStream(android::sp<AAudioServiceStreamBase> stream,
audio_port_handle_t *clientHandle) = 0;
virtual aaudio_result_t stopStream(android::sp<AAudioServiceStreamBase> stream,
audio_port_handle_t clientHandle) = 0;
virtual aaudio_result_t startClient(const android::AudioClient& client,
audio_port_handle_t *clientHandle) {
ALOGD("AAudioServiceEndpoint::startClient(%p, ...) AAUDIO_ERROR_UNAVAILABLE", &client);
return AAUDIO_ERROR_UNAVAILABLE;
}
virtual aaudio_result_t stopClient(audio_port_handle_t clientHandle) {
ALOGD("AAudioServiceEndpoint::stopClient(...) AAUDIO_ERROR_UNAVAILABLE");
return AAUDIO_ERROR_UNAVAILABLE;
}
/**
* @param positionFrames
* @param timeNanos
* @return AAUDIO_OK or AAUDIO_ERROR_UNAVAILABLE or other negative error
*/
virtual aaudio_result_t getFreeRunningPosition(int64_t *positionFrames, int64_t *timeNanos) = 0;
virtual aaudio_result_t getTimestamp(int64_t *positionFrames, int64_t *timeNanos) = 0;
int32_t getFramesPerBurst() const {
return mFramesPerBurst;
}
int32_t getRequestedDeviceId() const { return mRequestedDeviceId; }
bool matches(const AAudioStreamConfiguration& configuration);
// This should only be called from the AAudioEndpointManager under a mutex.
int32_t getOpenCount() const {
return mOpenCount;
}
// This should only be called from the AAudioEndpointManager under a mutex.
void setOpenCount(int32_t count) {
mOpenCount = count;
}
protected:
void disconnectRegisteredStreams();
mutable std::mutex mLockStreams;
std::vector<android::sp<AAudioServiceStreamBase>> mRegisteredStreams;
SimpleDoubleBuffer<Timestamp> mAtomicTimestamp;
android::AudioClient mMmapClient; // set in open, used in open and startStream
int32_t mFramesPerBurst = 0;
int32_t mOpenCount = 0;
int32_t mRequestedDeviceId = 0;
};
} /* namespace aaudio */
#endif //AAUDIO_SERVICE_ENDPOINT_H