289dfd037f
CellBroadcastService is bound to by the platform to handle cell broadcasts. Bug: 135956699 Test: manual Change-Id: Ib1b20da03d271fc0b2736774b2ca6c6514944093
113 lines
3.9 KiB
Java
113 lines
3.9 KiB
Java
/*
|
|
* Copyright (C) 2019 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.telephony;
|
|
|
|
import android.annotation.CallSuper;
|
|
import android.annotation.SystemApi;
|
|
import android.app.Service;
|
|
import android.content.Intent;
|
|
import android.os.IBinder;
|
|
|
|
/**
|
|
* A service which exposes the cell broadcast handling module to the system.
|
|
* <p>
|
|
* To extend this class, you must declare the service in your manifest file to require the
|
|
* {@link android.Manifest.permission#BIND_CELL_BROADCAST_SERVICE} permission and include an intent
|
|
* filter with the {@link #CELL_BROADCAST_SERVICE_INTERFACE}.
|
|
* Implementations of this service should run in the phone process and with its UID.
|
|
* <p>
|
|
* For example:
|
|
* <pre>{@code
|
|
* <manifest xmlns:android="http://schemas.android.com/apk/res/android"
|
|
* android:sharedUserId="android.uid.phone">
|
|
* <service android:name=".MyCellBroadcastService"
|
|
* android:label="@string/service_name"
|
|
* android:process="com.android.phone"
|
|
* android:exported="true"
|
|
* android:permission="android.permission.BIND_CELL_BROADCAST_SERVICE">
|
|
* <intent-filter>
|
|
* <action android:name="android.telephony.CellBroadcastService" />
|
|
* </intent-filter>
|
|
* </service>
|
|
* </manifest>
|
|
* }</pre>
|
|
* @hide
|
|
*/
|
|
@SystemApi
|
|
public abstract class CellBroadcastService extends Service {
|
|
|
|
public static final String CELL_BROADCAST_SERVICE_INTERFACE =
|
|
"android.telephony.CellBroadcastService";
|
|
|
|
private final ICellBroadcastService.Stub mStubWrapper;
|
|
|
|
public CellBroadcastService() {
|
|
mStubWrapper = new ICellBroadcastServiceWrapper();
|
|
}
|
|
|
|
/**
|
|
* Handle a GSM cell broadcast SMS message forwarded from the system.
|
|
* @param slotIndex the index of the slot which received the message
|
|
* @param message the SMS PDU
|
|
*/
|
|
public abstract void onGsmCellBroadcastSms(int slotIndex, byte[] message);
|
|
|
|
/**
|
|
* Handle a CDMA cell broadcast SMS message forwarded from the system.
|
|
* @param slotIndex the index of the slot which received the message
|
|
* @param message the SMS PDU
|
|
*/
|
|
public abstract void onCdmaCellBroadcastSms(int slotIndex, byte[] message);
|
|
|
|
/**
|
|
* If overriding this method, call through to the super method for any unknown actions.
|
|
* {@inheritDoc}
|
|
*/
|
|
@Override
|
|
@CallSuper
|
|
public IBinder onBind(Intent intent) {
|
|
return mStubWrapper;
|
|
}
|
|
|
|
/**
|
|
* A wrapper around ICellBroadcastService that forwards calls to implementations of
|
|
* {@link CellBroadcastService}.
|
|
* @hide
|
|
*/
|
|
public class ICellBroadcastServiceWrapper extends ICellBroadcastService.Stub {
|
|
/**
|
|
* Handle a GSM cell broadcast SMS.
|
|
* @param slotIndex the index of the slot which received the broadcast
|
|
* @param message the SMS message PDU
|
|
*/
|
|
@Override
|
|
public void handleGsmCellBroadcastSms(int slotIndex, byte[] message) {
|
|
CellBroadcastService.this.onGsmCellBroadcastSms(slotIndex, message);
|
|
}
|
|
|
|
/**
|
|
* Handle a CDMA cell broadcast SMS.
|
|
* @param slotIndex the index of the slot which received the broadcast
|
|
* @param message the SMS message PDU
|
|
*/
|
|
@Override
|
|
public void handleCdmaCellBroadcastSms(int slotIndex, byte[] message) {
|
|
CellBroadcastService.this.onCdmaCellBroadcastSms(slotIndex, message);
|
|
}
|
|
}
|
|
}
|