title: 范围监听

创建监听范围

- circleQueryAtPosition:withRadius: 根据位置与半径创建监听范围，单位为千米。

  1. WDGCircleQuery *circleQuery = [locationService circleQueryAtPosition:[[WDGPosition alloc] initWithLatitude:37.33617167 longitude:-122.08165962] withRadius:0.5];

事件

范围监听通过事件的方式实时获取设备的变化信息。

事件包括以下三种:

名称 说明
WDGQueryEventTypeEntered 设备进入了查询范围内时触发 WDGQueryEventTypeEntered 事件。初始化时所有范围内的设备都会触发一次该事件。
WDGQueryEventTypeExited 设备从查询范围内离开查询范围时，会触发 WDGQueryEventTypeExited 事件。如果这个 key 在云端被删除的话，被传递给回调函数的位置信息和距离信息将为null。
WDGQueryEventTypeMoved 设备已经在查询范围内部，当它在内部发生移动的时候，会触发 WDGQueryEventTypeMoved 事件。

监听范围事件

- observeReadyWithBlock:方法在WDGCircleQuery实例初始化完成或者查询被更新时触发，可以在该方法内设置更新UI的操作。

  1. [circleQuery observeReadyWithBlock:^{
  2.     NSLog(@"Observe ready!");
  3.     // Update UI.
  4. }];

- observeEventType:withBlock:方法用于与事件配合，监听范围内的设备数据。

  • WDGQueryEventTypeEntered 事件在设备进入范围时触发。
  1. [circleQuery observeEventType:WDGQueryEventTypeEntered withBlock:^(NSString * _Nonnull key, WDGPosition * _Nonnull location) {
  2.     NSLog(@"%@ Entered: (%g, %g)", key, location.latitude, location.longitude);
  3. }];
  • WDGQueryEventTypeExited 事件在设备离开范围时触发。
  1. [circleQuery observeEventType:WDGQueryEventTypeExited withBlock:^(NSString * _Nonnull key, WDGPosition * _Nonnull location) {
  2.     NSLog(@"%@ Exited: (%g, %g)", key, location.latitude, location.longitude);
  3. }];
  • WDGQueryEventTypeMoved 事件在监听范围内的设备移动时触发。
  1. [circleQuery observeEventType:WDGQueryEventTypeMoved withBlock:^(NSString * _Nonnull key, WDGPosition * _Nonnull location) {
  2.     NSLog(@"%@ Moved: (%g, %g)", key, location.latitude, location.longitude);
  3. }];

取消监听

- removeObserverWithHandle: 用于取消指定的范围监听。

  1. [circleQuery removeObserverWithHandle:handle];

- removeAllObservers 用于取消所有的范围监听。

  1. [circleQuery removeAllObservers];

实时变更监听范围

只要更改监听位置或者半径，发生在WDGCircleQuery实例上的监听事件就会自动更新，方法如下：

  1. // 更改监听位置
  2. circleQuery.center = [[CLLocation alloc] initWithLatitude:10.0 longitude:50.0];
  3. // 更改监听半径
  4. circleQuery.radius = 50.0;

例如，可以根据设备的实时位置不断更新监听范围。

  1. WilddogHandle handle = [locationService observeLocationForKey:@"key" withBlock:^(WDGPosition * _Nullable position, NSError * _Nullable error) {
  2.     if (error) {
  3.         // handle error here
  4.         return;
  5.     }
  6.     circleQuery.center = [[CLLocation alloc] initWithLatitude:position.latitude longitude:position.longitude];
  7. }];