104 lines
3.2 KiB
Java
104 lines
3.2 KiB
Java
|
/*
|
||
|
|
* Copyright 2020 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.
|
||
|
|
*/
|
||
|
|
package android.media;
|
||
|
|
|
||
|
|
import android.annotation.NonNull;
|
||
|
|
import android.annotation.Nullable;
|
||
|
|
import android.annotation.SystemApi;
|
||
|
|
import android.annotation.SystemApi.Client;
|
||
|
|
import android.os.IBinder;
|
||
|
|
import android.os.ServiceManager;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Provides a way to register and obtain the system service binder objects managed by the media
|
||
|
|
* service.
|
||
|
|
*
|
||
|
|
* <p> Only the media mainline module will be able to access an instance of this class.
|
||
|
|
* @hide
|
||
|
|
*/
|
||
|
|
@SystemApi(client = Client.MODULE_LIBRARIES)
|
||
|
|
public class MediaServiceManager {
|
||
|
|
private static final String MEDIA_SESSION_SERVICE = "media_session";
|
||
|
|
private static final String MEDIA_TRANSCODING_SERVICE = "media.transcoding";
|
||
|
|
private static final String MEDIA_COMMUNICATION_SERVICE = "media_communication";
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @hide
|
||
|
|
*/
|
||
|
|
public MediaServiceManager() {}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* A class that exposes the methods to register and obtain each system service.
|
||
|
|
*/
|
||
|
|
public static final class ServiceRegisterer {
|
||
|
|
private final String mServiceName;
|
||
|
|
private final boolean mLazyStart;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @hide
|
||
|
|
*/
|
||
|
|
public ServiceRegisterer(String serviceName, boolean lazyStart) {
|
||
|
|
mServiceName = serviceName;
|
||
|
|
mLazyStart = lazyStart;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @hide
|
||
|
|
*/
|
||
|
|
public ServiceRegisterer(String serviceName) {
|
||
|
|
this(serviceName, false /*lazyStart*/);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Get the system server binding object for MediaServiceManager.
|
||
|
|
*
|
||
|
|
* <p> This blocks until the service instance is ready.
|
||
|
|
* or a timeout happens, in which case it returns null.
|
||
|
|
*/
|
||
|
|
@Nullable
|
||
|
|
public IBinder get() {
|
||
|
|
if (mLazyStart) {
|
||
|
|
return ServiceManager.waitForService(mServiceName);
|
||
|
|
}
|
||
|
|
return ServiceManager.getService(mServiceName);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns {@link ServiceRegisterer} for MEDIA_SESSION_SERVICE.
|
||
|
|
*/
|
||
|
|
@NonNull
|
||
|
|
public ServiceRegisterer getMediaSessionServiceRegisterer() {
|
||
|
|
return new ServiceRegisterer(MEDIA_SESSION_SERVICE);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns {@link ServiceRegisterer} for MEDIA_TRANSCODING_SERVICE.
|
||
|
|
*/
|
||
|
|
@NonNull
|
||
|
|
public ServiceRegisterer getMediaTranscodingServiceRegisterer() {
|
||
|
|
return new ServiceRegisterer(MEDIA_TRANSCODING_SERVICE, true /*lazyStart*/);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns {@link ServiceRegisterer} for MEDIA_COMMUNICATION_SERVICE.
|
||
|
|
*/
|
||
|
|
@NonNull
|
||
|
|
public ServiceRegisterer getMediaCommunicationServiceRegisterer() {
|
||
|
|
return new ServiceRegisterer(MEDIA_COMMUNICATION_SERVICE);
|
||
|
|
}
|
||
|
|
}
|