Tổng quan

Một lớp trợ giúp để mở vùng chứa.

Đây là trình bao bọc xung quanh phương thức openContainerById:callback: (TAGManager) cho phương thức gọi có hỗ trợ thời gian chờ.

Sau đây là mẫu hiển thị thời gian chờ tối đa 0,1 giây để vùng chứa được tải trước khi hoàn nguyên về vùng chứa mặc định:

     NSTimeInterval timeout = 0.1;
     TagManager *tagManager = [TagManager instance];
     TAGContainerFuture *future =
         [TAGContainerOpener openContainerWithId:@"GTM-XXXX"
                                      tagManager:tagManager
                                        openType:kTAGOpenTypePreferNonDefault
                                         timeout:&timeout];
     TAGContainer *container = [future get];

Nếu phương thức gọi muốn được thông báo không đồng bộ khi vùng chứa có sẵn nhưng muốn chỉ định thời gian chờ 0,5 giây theo cách thủ công, thì phương thức gọi phải phân lớp con TAGContainerOpenerNotifier, hãy gọi openContainerWithId:tagManager:openType:timeout:notifier: (TAGContainerOpener) với thời gian chờ được đặt thành 0,5 và thêm phương thức triển khai vào thông báo vùng chứa có sẵn: (TAGpContainerOpenerNotifier

Hàm thành viên công khai tĩnh
(id< TAGContainerFuture >)	+ openContainerWithId:tagManager:openType:timeout:
	Chờ tối đa `timeout` giây để tải một vùng chứa (không mặc định hoặc mới tuỳ thuộc vào `openType` được chỉ định) và trả về `TAGContainerFuture`.
(void)	+ openContainerWithId:tagManager:openType:timeout:notifier:
	Chờ tối đa `timeout` giây để tải một vùng chứa (không mặc định hoặc mới tuỳ thuộc vào `openType` được chỉ định) và gọi một trình thông báo khi vùng chứa có sẵn.
(Khoảng thời gian NSTime)	+ defaultTimeout
	Trả về thời gian chờ mặc định để yêu cầu vùng chứa.

Tài liệu về hàm thành phần

+ (id<TAGContainerFuture>) openContainerWithId:	(NSString *)	containerId
Trình quản lý thẻ:	(TAGManager *)	tagManager
loại mở:	(TAGOpenType)	openType
thời gian chờ:	(NSTimeInterval *)	thời gian chờ

Chờ tối đa timeout giây để tải một vùng chứa (không mặc định hoặc mới tuỳ thuộc vào openType được chỉ định) và trả về TAGContainerFuture.

Nếu loại mở là kTAGOpenTypePreferNonDefault, thì một vùng chứa không mặc định (lưu hoặc truy xuất từ mạng) sẽ được tải và TAGContainerFuture sẽ được bỏ chặn ngay khi một trong các trường hợp sau đây xảy ra:

một vùng chứa đã lưu sẽ được tải.
Nếu không có vùng chứa nào được lưu, thì vùng chứa mạng sẽ được tải hoặc xảy ra lỗi mạng.
đồng hồ hẹn giờ hết hạn.

Nếu xảy ra lỗi mạng hoặc bộ tính giờ hết hạn, get (TAGContainerFuture-p) có thể trả về vùng chứa mặc định.

Nếu loại mở là kTAGOpenTypePreferFresh, thì một vùng chứa mới (đã lưu hoặc truy xuất từ mạng) sẽ được tải và TAGContainerFuture sẽ được bỏ chặn ngay khi một trong các trường hợp sau xảy ra:

một vùng chứa mới đã lưu sẽ được tải.
Nếu không có vùng chứa đã lưu hoặc vùng chứa đã lưu đã cũ, thì vùng chứa mạng đã được tải hoặc xảy ra lỗi mạng.
đồng hồ hẹn giờ hết hạn.

Nếu xảy ra lỗi mạng hoặc bộ tính giờ hết hạn, get (TAGContainerFuture-p) có thể chứa các giá trị mặc định hoặc vùng chứa đã lưu cũ.

Nếu bạn gọi một trong các phương thức openContainer lần thứ hai với containerId nhất định, thì TAGContainerFuture sẽ được trả về có get (TAGContainerFuture-p) sẽ trả về chính vùng chứa như lệnh gọi đầu tiên.

Các tham số:

containerId	Mã vùng chứa cần tải.
tagManager	TAGManager để lấy vùng chứa.
tạm ngừng	Số giây chờ tối đa để tải vùng chứa từ cửa hàng đã lưu. Nếu giá trị bằng nil, defaultTimeout sẽ được sử dụng.
openType	Lựa chọn cách mở vùng chứa.

Trả về:: Một TAGContainerFuture sẽ đợi đến timeout và trả về vùng chứa khi có sẵn.

+ (vô hiệu) openContainerWithId:	(NSString *)	containerId
Trình quản lý thẻ:	(TAGManager *)	tagManager
loại mở:	(TAGOpenType)	openType
thời gian chờ:	(NSTimeInterval *)	thời gian chờ
trình thông báo:	(id< TAGContainerOpenerNotifier >)	trình thông báo

Chờ tối đa timeout giây để tải một vùng chứa (không mặc định hoặc mới tuỳ thuộc vào openType được chỉ định) và gọi một trình thông báo khi vùng chứa có sẵn.

Nếu loại mở là kTAGOpenTypePreferNonDefault, thì một vùng chứa không mặc định (đã lưu hoặc truy xuất từ mạng) sẽ được tải và truyền vào trình thông báo. Trình thông báo sẽ được gọi ngay khi một trong các trường hợp sau đây xảy ra:

một vùng chứa đã lưu sẽ được tải.
Nếu không có vùng chứa nào được lưu, thì vùng chứa mạng sẽ được tải hoặc xảy ra lỗi mạng.
đồng hồ hẹn giờ hết hạn.

Nếu xảy ra lỗi mạng hoặc bộ tính giờ hết hạn, thì vùng chứa được chuyển vào trình thông báo là vùng chứa mặc định.

Nếu loại mở là kTAGOpenTypePreferFresh, thì một vùng chứa làm mới (đã lưu hoặc truy xuất từ mạng) sẽ được tải và chuyển vào trình thông báo. Trình thông báo sẽ được gọi ngay khi một trong các trường hợp sau đây xảy ra:

một vùng chứa mới đã lưu sẽ được tải.
Nếu không có vùng chứa đã lưu hoặc vùng chứa đã lưu đã cũ, thì vùng chứa mạng đã được tải hoặc xảy ra lỗi mạng.
đồng hồ hẹn giờ hết hạn.

Nếu xảy ra lỗi mạng hoặc bộ tính giờ hết hạn, thì vùng chứa được chuyển vào trình thông báo có thể chứa các giá trị mặc định hoặc vùng chứa đã lưu cũ.

Nếu bạn gọi một trong các phương thức openContainer lần thứ hai với containerId nhất định, chính vùng chứa được trả về từ lệnh gọi trước đó sẽ được chuyển vào trình thông báo ngay khi có sẵn.

Các tham số:

containerId	Mã vùng chứa cần tải.
tagManager	TAGManager dùng để lấy vùng chứa.
openType	Lựa chọn cách mở vùng chứa.
tạm ngừng	Số giây chờ tối đa để tải vùng chứa từ cửa hàng đã lưu. Nếu giá trị bằng nil, defaultTimeout sẽ được sử dụng.
trình thông báo	Một trình thông báo tuỳ chọn sẽ được gọi khi vùng chứa có sẵn. Phương thức này sẽ được gọi với vùng chứa làm mới (nếu có) và được tải trước khi hết thời gian chờ; nếu không, phương thức này sẽ được gọi bằng vùng chứa không làm mới. Xin lưu ý rằng trình thông báo này có thể được gọi từ một luồng khác.

+ (NSTimeInterval) defaultTimeout

Trả về thời gian chờ mặc định để yêu cầu vùng chứa.

Trả về:: Thời gian chờ mặc định tính bằng giây.

Tài liệu tham khảo về TAGContainerOpener về Lớp

Tổng quan

Hàm thành viên công khai tĩnh

Tài liệu về hàm thành phần