Merge "TIS: Standardize TIS Service Database Extensions API" into main

/*

 * 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);

}

/*

 * 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);

}

/*

 * 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);

}

/*

 * 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);

}

/*

 * 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);

}