Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit cc191c3c authored by Sherry Huang's avatar Sherry Huang
Browse files

TIS: Standardize TIS Service Database Extensions API 

Define standardized AIDL interfaces for service database extension package.

Flag: android.media.tv.flags.tif_extension_standardization
Bug: b/344029126
Test: local testing with m
Change-Id: I418cdee4d467c0da0e06aee17964b00f6c6ae83a
parent 8a9da474

media/java/android/media/tv/extension/servicedb/IChannelListTransfer.aidl

0 → 100644
+29 −0
Original line number Diff line number Diff line 
/*

 * Copyright (C) 2024 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.tv.extension.servicedb;



import android.os.ParcelFileDescriptor;



/**

 * @hide

 */

interface IChannelListTransfer {

    // Parse XML file and import Channels information.

    void importChannelList(in ParcelFileDescriptor pfd);

    // Get Channels information for export and create XML file.

    void exportChannelList(in ParcelFileDescriptor pfd);

}

media/java/android/media/tv/extension/servicedb/IServiceList.aidl

0 → 100644
+30 −0
Original line number Diff line number Diff line 
/*

 * Copyright (C) 2024 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.tv.extension.servicedb;



import android.os.Bundle;



/**

 * @hide

 */

interface IServiceList {

    // Get a list of the Service list IDs quivalent to COLUMN_CHANNEL_LIST_ID

    // in the Channels table of TvProvider.

    String[] getServiceListIds();

    // Get the information associated with the Service list.

    Bundle getServiceListInfo(String serviceListId, in String[] keys);

}

media/java/android/media/tv/extension/servicedb/IServiceListEdit.aidl

0 → 100644
+81 −0
Original line number Diff line number Diff line 
/*

 * Copyright (C) 2024 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.tv.extension.servicedb;



import android.media.tv.extension.servicedb.IServiceListEditListener;

import android.os.Bundle;



/**

 * @hide

 */

interface IServiceListEdit {

    // Open in edit mode. Must call close() after edit is done.

    int open(IServiceListEditListener listener);

    // Method to close in edit mode.

    int close();

    // Method to commit changes made to service database.

    int commit();

    // Method to commit and close the changes.

    int userEditCommit();



    // Get a service/transportStream/Network/Satellite record information specified by

    // serviceInfoId and keys from tvdb.

    Bundle getServiceInfoFromDatabase(String serviceInfoId, in String[] keys);

    // Get a list of all service records' information specified by serviceListId and keys from tvdb.

    Bundle getServiceInfoListFromDatabase(String serviceListId, in String[] keys);

    // Get a list of all service info IDs in the service list of serviceListId from tvdb.

    String[] getServiceInfoIdsFromDatabase(String inServiceListId);

    // Update a service information by the contents of serviceInfo;

    int updateServiceInfoFromDatabase(in Bundle updateServiceInfo);

    // Update all service information by the contents of serviceInfoList.

    int updateServiceInfoByListFromDatabase(in Bundle[] updateServiceInfoList);

    // Remove a service information of the serviceInfoId from the service list.

    int removeServiceInfoFromDatabase(String serviceInfoId);

    // Remove all service information of the serviceInfoId from the service list.

    int removeServiceInfoByListFromDatabase(in String[] serviceInfoIdList);

    // Get a list of the Service list IDs which is equivalent to COLUMN_CHANNEL_LIST_ID

    // in Channels table from tv db.

    String[] getServiceListChannelIds();

    // Get the information associated with the Service list Channel id.

    Bundle getServiceListInfoByChannelId(String serviceListChannelId, in String[] keys);



    // Get a list of transportStream records' information specified by serviceListId and keys.

    Bundle getTransportStreamInfoList(String serviceListId, in String[] keys);

    // Get a list of transportStream records' information specified by serviceListId and keys

    // from work db.

    Bundle getTransportStreamInfoListForce(String serviceListId, in String[] keys);



    // Get a list of network records' information specified by serviceListId and keys.

    Bundle getNetworkInfoList(String serviceListId, in String[] keys);

    // Get a list of satellite records' information specified by serviceListId and keys.

    Bundle getSatelliteInfoList(String serviceListId, in String[] keys);



    // Decompress whole bundle value of single service/transportStream/Network/Satellite record.

    // RecordInfoBundle:a single record got from database by getServiceInfoFromDatabase()

    String toRecordInfoByType(in Bundle recordInfoBundle, String recordType);

    // Set channels(tv.db) modified result to middleware database(SVL/TSL/NWL/SATL).

    int putRecordIdList(String serviceListId, in Bundle recordIdListBundle, int optType);



    // Add predefined ServiceListInfo of Hotbird 13E in scan two satellite scene EU region

    // following by commit().

    String addPredefinedServiceListInfo(int broadcastType, String serviceListType,

        String serviceListPrefix, String countryCode, int operatorId);

    // Add predefined channels of Hotbird 13E in scan two satellite scene EU region.

    int addPredefinedChannelList(String serviceListId, in Bundle[] predefinedListBundle);

    // Add predefined satellite info of Hotbird 13E in scan two satellite scene EU region.

    int addPredefinedSatInfo(String serviceListId, in Bundle predefinedSatInfoBundle);

}

media/java/android/media/tv/extension/servicedb/IServiceListEditListener.aidl

0 → 100644
+24 −0
Original line number Diff line number Diff line 
/*

 * Copyright (C) 2024 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.tv.extension.servicedb;



/**

 * @hide

 */

oneway interface IServiceListEditListener {

    void onCompleted(int requestId, int result);

}

media/java/android/media/tv/extension/servicedb/IServiceListExportListener.aidl

0 → 100644
+24 −0
Original line number Diff line number Diff line 
/*

 * Copyright (C) 2024 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.tv.extension.servicedb;



/**

 * @hide

 */

oneway interface IServiceListExportListener {

    void onExported(int exportResult);

}