Skip to content

searchGamesWithOptions:completion: ​

搜索游戏 ​

根据关键词搜索游戏,并通过游标分页返回结果。调用前须完成 SDK 初始化。该方法请求 /v1/game/search。


方法声明 ​

objectivec
+ (void)searchGamesWithOptions:(nullable SUDOPGameSearchOptions *)options
                    completion:(nullable void(^)(SUDOPGameSearchResult *_Nullable result,
                                                  NSError *_Nullable error))completion;

SUDOPGameSearchOptions ​

字段类型默认值描述
keywordNSString *nil必传。非空搜索关键词,首尾空白会被移除。
languageNSString *nil语言标识,如 zh-CN;nil 或空字符串使用服务端默认值。
cursorNSString *nil上一页返回的游标;首次请求传 nil。
pageSizeNSInteger10每页条数;小于或等于 0 时按 10 处理。

返回模型 ​

字段类型描述
listNSArray<SUDOPGameSearchItem *> *当前页游戏。每项包含 gameId、多语言 gameName 和多语言图标 icon。
paginationSUDOPGameSearchPagination *分页信息,包含 total、hasMore 和可空的 nextCursor。

代码示例 ​

objectivec
SUDOPGameSearchOptions *options = [[SUDOPGameSearchOptions alloc] init];
options.keyword = @"party";
options.language = @"zh-CN";
options.pageSize = 20;

[SUDOP searchGamesWithOptions:options
                   completion:^(SUDOPGameSearchResult * _Nullable result,
                                NSError * _Nullable error) {
    if (error) {
        NSLog(@"搜索游戏失败: %@", error.localizedDescription);
        return;
    }
    NSLog(@"当前返回: %ld,是否有下一页: %@",
          (long)result.list.count,
          result.pagination.hasMore ? @"是" : @"否");
}];

注意事项 ​

  • options 或 keyword 为空、空字符串或仅包含空白字符时,SDK 会返回参数错误。
  • 加载下一页时,将上一页的 nextCursor 原样赋给新请求的 cursor。
  • 回调在主线程执行。