1 /* 2 * Copyright (C) 2016 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 #ifndef ANDROID_AAUDIO_IAAUDIO_SERVICE_H 18 #define ANDROID_AAUDIO_IAAUDIO_SERVICE_H 19 20 #include <stdint.h> 21 #include <utils/RefBase.h> 22 #include <binder/TextOutput.h> 23 #include <binder/IInterface.h> 24 25 #include <aaudio/AAudio.h> 26 27 #include "binding/AAudioCommon.h" 28 #include "binding/AAudioServiceDefinitions.h" 29 #include "binding/AAudioStreamConfiguration.h" 30 #include "binding/AAudioStreamRequest.h" 31 #include "binding/AudioEndpointParcelable.h" 32 #include "binding/IAAudioClient.h" 33 34 namespace android { 35 36 #define AAUDIO_SERVICE_NAME "media.aaudio" 37 38 // Interface (our AIDL) - service methods called by client 39 class IAAudioService : public IInterface { 40 public: 41 42 DECLARE_META_INTERFACE(AAudioService); 43 44 // Register an object to receive audio input/output change and track notifications. 45 // For a given calling pid, AAudio service disregards any registrations after the first. 46 // Thus the IAAudioClient must be a singleton per process. 47 virtual void registerClient(const sp<IAAudioClient>& client) = 0; 48 49 /** 50 * @param request info needed to create the stream 51 * @param configuration contains information about the created stream 52 * @return handle to the stream or a negative error 53 */ 54 virtual aaudio::aaudio_handle_t openStream(const aaudio::AAudioStreamRequest &request, 55 aaudio::AAudioStreamConfiguration &configurationOutput) = 0; 56 57 virtual aaudio_result_t closeStream(aaudio::aaudio_handle_t streamHandle) = 0; 58 59 /* Get an immutable description of the in-memory queues 60 * used to communicate with the underlying HAL or Service. 61 */ 62 virtual aaudio_result_t getStreamDescription(aaudio::aaudio_handle_t streamHandle, 63 aaudio::AudioEndpointParcelable &parcelable) = 0; 64 65 /** 66 * Start the flow of data. 67 * This is asynchronous. When complete, the service will send a STARTED event. 68 */ 69 virtual aaudio_result_t startStream(aaudio::aaudio_handle_t streamHandle) = 0; 70 71 /** 72 * Stop the flow of data such that start() can resume without loss of data. 73 * This is asynchronous. When complete, the service will send a PAUSED event. 74 */ 75 virtual aaudio_result_t pauseStream(aaudio::aaudio_handle_t streamHandle) = 0; 76 77 /** 78 * Stop the flow of data such that the data currently in the buffer is played. 79 * This is asynchronous. When complete, the service will send a STOPPED event. 80 */ 81 virtual aaudio_result_t stopStream(aaudio::aaudio_handle_t streamHandle) = 0; 82 83 /** 84 * Discard any data held by the underlying HAL or Service. 85 * This is asynchronous. When complete, the service will send a FLUSHED event. 86 */ 87 virtual aaudio_result_t flushStream(aaudio::aaudio_handle_t streamHandle) = 0; 88 89 /** 90 * Manage the specified thread as a low latency audio thread. 91 */ 92 virtual aaudio_result_t registerAudioThread(aaudio::aaudio_handle_t streamHandle, 93 pid_t clientThreadId, 94 int64_t periodNanoseconds) = 0; 95 96 virtual aaudio_result_t unregisterAudioThread(aaudio::aaudio_handle_t streamHandle, 97 pid_t clientThreadId) = 0; 98 }; 99 100 class BnAAudioService : public BnInterface<IAAudioService> { 101 public: 102 virtual status_t onTransact(uint32_t code, const Parcel& data, 103 Parcel* reply, uint32_t flags = 0); 104 105 }; 106 107 } /* namespace android */ 108 109 #endif //ANDROID_AAUDIO_IAAUDIO_SERVICE_H 110
