Merge "Add CDMA SCP message handling to CellBroadcast module"

This commit is contained in:
Jordan Liu
2019-11-06 17:13:51 +00:00
committed by Gerrit Code Review
4 changed files with 81 additions and 6 deletions

View File

@@ -7288,6 +7288,7 @@ package android.telephony {
ctor public CellBroadcastService();
method @CallSuper @NonNull public android.os.IBinder onBind(@Nullable android.content.Intent);
method public abstract void onCdmaCellBroadcastSms(int, @NonNull byte[], int);
method public abstract void onCdmaScpMessage(int, @NonNull java.util.List<android.telephony.cdma.CdmaSmsCbProgramData>, @NonNull String, @NonNull java.util.function.Consumer<android.os.Bundle>);
method public abstract void onGsmCellBroadcastSms(int, @NonNull byte[]);
field public static final String CELL_BROADCAST_SERVICE_INTERFACE = "android.telephony.CellBroadcastService";
}

View File

@@ -22,9 +22,14 @@ import android.annotation.Nullable;
import android.annotation.SystemApi;
import android.app.Service;
import android.content.Intent;
import android.os.Bundle;
import android.os.IBinder;
import android.os.RemoteCallback;
import android.telephony.cdma.CdmaSmsCbProgramData;
import java.util.List;
import java.util.function.Consumer;
/**
* A service which exposes the cell broadcast handling module to the system.
* <p>
@@ -48,6 +53,7 @@ import android.telephony.cdma.CdmaSmsCbProgramData;
* </service>
* </manifest>
* }</pre>
*
* @hide
*/
@SystemApi
@@ -64,20 +70,37 @@ public abstract class CellBroadcastService extends Service {
/**
* 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
* @param message the SMS PDU
*/
public abstract void onGsmCellBroadcastSms(int slotIndex, @NonNull 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 bearerData the CDMA SMS bearer data
*
* @param slotIndex the index of the slot which received the message
* @param bearerData the CDMA SMS bearer data
* @param serviceCategory the CDMA SCPT service category
*/
public abstract void onCdmaCellBroadcastSms(int slotIndex, @NonNull byte[] bearerData,
@CdmaSmsCbProgramData.Category int serviceCategory);
/**
* Handle a CDMA cell broadcast SMS message forwarded from the system.
*
* @param slotIndex the index of the slot which received the message
* @param smsCbProgramData the SMS CB program data of the message
* @param originatingAddress the originating address of the message, as a non-separated dial
* string
* @param callback a callback to run after each cell broadcast receiver has handled
* the SCP message. The bundle will contain a non-separated
* dial string as and an ArrayList of {@link CdmaSmsCbProgramResults}.
*/
public abstract void onCdmaScpMessage(int slotIndex,
@NonNull List<CdmaSmsCbProgramData> smsCbProgramData,
@NonNull String originatingAddress, @NonNull Consumer<Bundle> callback);
/**
* If overriding this method, call through to the super method for any unknown actions.
* {@inheritDoc}
@@ -92,13 +115,15 @@ public abstract class CellBroadcastService extends Service {
/**
* 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
* @param message the SMS message PDU
*/
@Override
public void handleGsmCellBroadcastSms(int slotIndex, byte[] message) {
@@ -107,8 +132,9 @@ public abstract class CellBroadcastService extends Service {
/**
* Handle a CDMA cell broadcast SMS.
* @param slotIndex the index of the slot which received the broadcast
* @param bearerData the CDMA SMS bearer data
*
* @param slotIndex the index of the slot which received the broadcast
* @param bearerData the CDMA SMS bearer data
* @param serviceCategory the CDMA SCPT service category
*/
@Override
@@ -117,5 +143,25 @@ public abstract class CellBroadcastService extends Service {
CellBroadcastService.this.onCdmaCellBroadcastSms(slotIndex, bearerData,
serviceCategory);
}
/**
* Handle a CDMA Service Category Program message.
*
* @param slotIndex the index of the slot which received the message
* @param smsCbProgramData the SMS CB program data of the message
* @param originatingAddress the originating address of the message
* @param callback a callback to run after each cell broadcast receiver has
* handled the SCP message
*/
@Override
public void handleCdmaScpMessage(int slotIndex,
List<CdmaSmsCbProgramData> smsCbProgramData, String originatingAddress,
RemoteCallback callback) {
Consumer<Bundle> consumer = bundle -> {
callback.sendResult(bundle);
};
CellBroadcastService.this.onCdmaScpMessage(slotIndex, smsCbProgramData,
originatingAddress, consumer);
}
}
}

View File

@@ -16,6 +16,9 @@
package android.telephony;
import android.os.RemoteCallback;
import android.telephony.cdma.CdmaSmsCbProgramData;
/**
* Service bound to by the system to allow custom handling of cell broadcast messages.
* <p>
@@ -29,4 +32,8 @@ interface ICellBroadcastService {
/** @see android.telephony.CellBroadcastService#onCdmaCellBroadcastSms */
oneway void handleCdmaCellBroadcastSms(int slotId, in byte[] bearerData, int serviceCategory);
/** @see android.telephony.CellBroadcastService#onCdmaScpMessage */
oneway void handleCdmaScpMessage(int slotId, in List<CdmaSmsCbProgramData> programData,
String originatingAddress, in RemoteCallback callback);
}

View File

@@ -0,0 +1,21 @@
/*
* 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.
*/
/** @hide */
package android.telephony.cdma;
parcelable CdmaSmsCbProgramData;