總覽
GMSAutocompleteFetcher 是較低階自動完成 API 的包裝函式,其內會封裝使用者輸入內容時要求自動完成預測的複雜性。
呼叫 sourceTextHasChanged 時,通常會導致系統呼叫提供的委派,並針對查詢的文字提供預測查詢字串,並具備以下概念:
- 如果短時間內發出多次要求,擷取器不一定會要求預測每個 sourceTextHasChanged。
- 只有在最近呼叫 sourceTextHasChanged 中所提供文字的預測結果時,才會搭配預測結果呼叫委派。
公開成員函式 | |
(執行個體類型) | - initWithFilter: |
初始化擷取器。 | |
(void) | - provideSessionToken: |
提供 GMSAutocompleteSessionToken 以追蹤特定的自動完成查詢流程。 | |
(void) | - sourceTextHasChanged: |
通知擷取器,要自動完成的來源文字已變更。 | |
資源 | |
id < GMSAutocompleteFetcherDelegate > | 委派 |
接收自動完成預測結果通知的委派代表。 | |
GMSAutocompleteFilter * | autocompleteFilter |
篩選出來套用至自動完成建議的項目 (可以設為 nil)。 |
成員函式說明文件
- (instancetype) initWithFilter: | (可為空值 GMSAutocompleteFilter *) | 篩選器 |
初始化擷取器。
- 參數:
-
過濾器 要套用至結果的篩選器。這個參數可以是 nil。
- (void) provideSessionToken: | (可為空值 GMSAutocompleteSessionToken *) | sessionToken |
提供 GMSAutocompleteSessionToken
以追蹤特定的自動完成查詢流程。
- (void) sourceTextHasChanged: | (nullable NSString *) | 文字 |
通知擷取器,要自動完成的來源文字已變更。
這個方法只能從主執行緒呼叫。從其他執行緒呼叫此方法會導致未定義的行為。系統也會在主執行緒上呼叫 GMSAutocompleteFetcherDelegate
方法。
這個方法屬於非阻塞式做法。
- 參數:
-
text 要自動完成的部分文字。
屬性說明文件
- (id<GMSAutocompleteFetcherDelegate>) 委派 [read, write, assign] |
接收自動完成預測結果通知的委派代表。
- (GMSAutocompleteFilter*) autocompleteFilter [read, write, assign] |
篩選出來套用至自動完成建議的項目 (可以設為 nil)。