searchGamesWithOptions:completion:
搜索游戏
根据关键词搜索游戏,并通过游标分页返回结果。调用前须完成 SDK 初始化。该方法请求 /v1/game/search。
方法声明
objectivec
+ (void)searchGamesWithOptions:(nullable SUDOPGameSearchOptions *)options
completion:(nullable void(^)(SUDOPGameSearchResult *_Nullable result,
NSError *_Nullable error))completion;SUDOPGameSearchOptions
| 字段 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| keyword | NSString * | nil | 必传。非空搜索关键词,首尾空白会被移除。 |
| language | NSString * | nil | 语言标识,如 zh-CN;nil 或空字符串使用服务端默认值。 |
| cursor | NSString * | nil | 上一页返回的游标;首次请求传 nil。 |
| pageSize | NSInteger | 10 | 每页条数;小于或等于 0 时按 10 处理。 |
返回模型
| 字段 | 类型 | 描述 |
|---|---|---|
| list | NSArray<SUDOPGameSearchItem *> * | 当前页游戏。每项包含 gameId、多语言 gameName 和多语言图标 icon。 |
| pagination | SUDOPGameSearchPagination * | 分页信息,包含 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。 - 回调在主线程执行。
