tencent cloud

搜索小程序
下载PDF
最后更新时间：2025-07-04 16:48:08
搜索小程序
最后更新时间： 2025-07-04 16:48:08
下载PDF
小程序 SDK 提供线上小程序搜索的接口，可以通过此接口对小程序按关键字和分类进行搜索。
API 说明：
说明：
SearchOptions 参数用于指定小程序搜索的关键字和分类信息。
MiniCallback 参数用于获取小程序的搜索结果。
/**
 * 小程序搜索
 *
 * @param searchOptions
 * @param callback
 */
public static void searchMiniApp(SearchOptions searchOptions, MiniCallback<List<MiniApp>> callback)

按关键字搜索

示例代码：
SearchOptions searchOptions = new SearchOptions("yourkeyword");
TmfMiniSDK.searchMiniApp(searchOptions, new MiniCallback<List<MiniApp>>() {
    @Override
    public void value(int code, String msg, List<MiniApp> data) {
        if (code == MiniCode.CODE_OK && data != null) {
            //搜索成功，列表不为空
        }else{
            //搜索失败，或列表为空
        }
    }
});

按单分类搜索

示例代码：
SearchOptions searchOptions = new SearchOptions("","分类名称","");
TmfMiniSDK.searchMiniApp(searchOptions, new MiniCallback<List<MiniApp>>() {
    @Override
    public void value(int code, String msg, List<MiniApp> data) {
        if (code == MiniCode.CODE_OK && data != null) {
            //搜索成功，列表不为空
        }else{
            //搜索失败，或列表为空
        }
    }
});

双分类搜索

说明：
双分类搜索的结果为两个分类的交集。
示例代码：
SearchOptions searchOptions = new SearchOptions("","分类名称","分类名称2");
TmfMiniSDK.searchMiniApp(searchOptions, new MiniCallback<List<MiniApp>>() {
    @Override
    public void value(int code, String msg, List<MiniApp> data) {
        if (code == MiniCode.CODE_OK && data != null) {
            //搜索成功，列表不为空
        }else{
            //搜索失败，或列表为空
        }
    }
});

关键字和分类搜索

说明：
搜索参数同时设置关键字分类，搜索结果为关键字和分类的交集。
示例代码：
SearchOptions searchOptions = new SearchOptions("keyword","分类名称","分类名称2");
TmfMiniSDK.searchMiniApp(searchOptions, new MiniCallback<List<MiniApp>>() {
    @Override
    public void value(int code, String msg, List<MiniApp> data) {
        if (code == MiniCode.CODE_OK && data != null) {
            //搜索成功，列表不为空
        }else{
            //搜索失败，或列表为空
        }
    }
});

指定搜索小程序或小游戏

说明：
SDK 2.2.0 版本开始支持小游戏，搜索接口也做了相应调整，支持指定搜索小游戏或小程序，默认搜索小程序和小游戏。
示例代码：
//指定搜索小游戏
SearchOptions searchOptions = new SearchOptions("keyword", "分类名称", "分类名称2");
searchOptions.engineType = MiniEngineType.MiniGame;
TmfMiniSDK.searchMiniApp(searchOptions, new MiniCallback<List<MiniApp>>() {
    @Override
    public void value(int code, String msg, List<MiniApp> data) {
        if (code == MiniCode.CODE_OK && data != null) {
            //搜索成功，列表不为空
        }else{
            //搜索失败，或列表为空
        }
    }
});

分页搜索

说明：
SDK 2.2.4 版本开始支持分页搜索，通过 SearchOptions 设置分页参数，SearchResult 返回分页列表及命中小程序总数。
示例代码：
SearchOptions searchOptions = new SearchOptions("keyword", "分类名称", "分类名称2");
searchOptions.pageIndex = index; // 页码，大于0，为0表示不分页 (2.2.4以上版本支持)
searchOptions.pageSize = size; // 页大小，大于0, 为0表示不分页 (2.2.4以上版本支持)
TmfMiniSDK.searchMiniApp2(searchOptions, new MiniCallback<SearchResult>() {
    @Override
    public void value(int code, String msg, SearchResult data) {
        if (code == MiniCode.CODE_OK && data != null && data.miniAppList != null) {
           //搜索成功，列表不为空
           //data.total:命中小程序总数，可根据总数计算页数
           //data.miniAppList:当前页面小程序列表
        } else {
           //搜索失败，或列表为空
        }
    }
});

本页内容是否解决了您的问题？
您也可以 联系销售 或 提交工单 以寻求帮助。
是
否

文档反馈