BlackBerry Java客户端开发项目实例教程四

 • 二维码扫描

二维码扫描有很多实用场景，比如BBM通过二维码扫描添加好友、扫描产品二维码标识、扫描二维码ID等等。在Demo应用中使用二维码扫描订单ID，并检查该订单状态。BlackBerry二维码扫描关键的类包括：

BarcodeDecoder  - 能够解析1D、2D条形码

BarcodeDecoderListener – 二维码扫描后的回调接口，用户处理获取的二维码

BarcodeScanner – 启动摄像头进行扫描

 

实现扫描的步骤：

 

(1). 创建BarcodeDecoder，配置使用哪一种解码，参考ViewFinderScreen的构造函数

 

 

// 初始化BarcodeDecoder，配置解码识别为QR编码格式

Hashtable hints = new Hashtable(1);

Vector formats = new Vector(1);

formats.addElement(BarcodeFormat.QR_CODE);

hints.put(DecodeHintType.POSSIBLE_FORMATS, formats);

 

// 使用配置的解码格式初始化 BarcodeDecoder

BarcodeDecoder decoder = new BarcodeDecoder(hints);

 

 

(2). 实现解码识别回调接口 BarcodeDecoderListener，在该接口中处理已获取的二维码，参考ViewFinderScreen构造函数。

 

// 创建BarcodeDecoderListener来处理识别的QR编码

BarcodeDecoderListener decoderListener = new BarcodeDecoderListener() {

                 

public void barcodeDecoded(final String rawText) {

 

    UiApplication.getUiApplication().invokeLater(new Runnable() {

      public void run() {

         // 处理识别的QR编码

                                   

      }

}

 

}

 

 

(3). 创建BarcodeScanner，启动扫描，参考ViewFinderScreen构造函数。

 

 

try {

// 使用创建的decoder与decoderListener来初始化BarcodeScanner，然后与view

// finder 关联并添加到当前屏幕上。

    _scanner = new BarcodeScanner(decoder, decoderListener);

    _scanner.getVideoControl().setDisplayFullScreen(true);

    add(_scanner.getViewfinder());

 

    } catch (Exception e) {

      displayMessage("Error: " + e.getMessage());

}

 

 

(4). 初始化完毕，启动扫描，参考ViewFinderScreen.startScan()。

  

public void startScan() {

  try {

         _scanner.startScan();// 启动扫描

      } catch (MediaException me) {

         displayMessage("Error: " + me.getMessage());

  }

}

 

 

• 获取地理位置、调用Google地图显示位置

地理位置的获取主要通过LocationProvider来实现，主要的类包括：

Criteria – 配置地理位置定位模式，如产生费用、精确度、反应时间、GPS还是基站定位等

LocationProvider – 根据配置的Criteria获取地理位置的经度、纬度

MapField – 通过获取的经度、纬度调用Google地图，显示在MapField上

 

 
实现的步骤如下：

(1). 配置地理位置定位标准Criteria，参考LocationThread.setupCriteria()

 

private void setupCriteria() {

 

      criteria = new Criteria();

      criteria.setPreferredResponseTime(15); // 设置相应时间 15s

 

      if (OptionsData.getInstance().getGPSMode() == OptionsData.GPS_GPS) {

        // 配置GPS模式

       

        criteria.setCostAllowed(false);

        criteria.setHorizontalAccuracy(20); // 20 meter;

        Logger.log("Criteria set for Standalone");

     

      } else if (OptionsData.getInstance().getGPSMode() ==  

                 OptionsData.GPS_CELL) {

 

        // 配置基站模式

        criteria.setCostAllowed(true);

        criteria.setHorizontalAccuracy(Criteria.NO_REQUIREMENT);

        criteria.setVerticalAccuracy(Criteria.NO_REQUIREMENT);

        criteria.setPreferredPowerConsumption(Criteria.POWER_USAGE_LOW);

        Logger.log("Criteria set for Cellsite(s)");

      }

}

 

(2).  配置LocationProvider，参考LocationThread.setupProvider()

 

private void setupProvider() {

  try {

      try {

            Thread.sleep(2000);

      } catch (Throwable e) {}

 

      // 使用criteria配置LocationProvider

      provider = LocationProvider.getInstance(criteria);

      Logger.log("LocationProvider initialized");

 

      if (provider != null) {

         singleFixLocationUpdate();

      } else {

         Logger.log("Provider unavailable for that Criteria");

      }

 

  } catch (LocationException le) {

      Logger.log(le.toString());

  }

}

 

(3). 获取地理位置信息、经度、纬度，参考LocationThread.singleFixLocationUpdate()

 

private void singleFixLocationUpdate() {

  Location location = null;

  try {

      location = provider.getLocation(10000);

  } catch (InterruptedException ie) {

      Logger.log("InterruptedException thrown by getLocation(): "

                              + ie.getMessage());

  } catch (LocationException le) {

      Logger.log("LocationException thrown by getLocation(): "

                              + le.getMessage());

  }

  if (location != null) {

     if (location.isValid()) {

        // 获取经度、纬度

        double latitude=location.getQualifiedCoordinates().getLatitude();

        double longitude=location.getQualifiedCoordinates().getLongitude();

 

        this.doc.setLatitude(latitude);

        this.doc.setLongitude(longitude);

        this.doc.setHasLocation(true);

                       

        String ll=this.doc.getLocationString(); //为Google Map组建位置信息

                       

        String url = "http://maps.google.com/maps/api/staticmap?center=" +ll;

        url += "&zoom=15";

        url += "&size=" + Display.getWidth() + "x250";

        url += "&&sensor=false&markers=color:blue|label:C|" +ll;

                       

        UiApplication.getUiApplication().invokeLater(new Runnable(){

            public void run(){

              Screen screen =

                     UiApplication.getUiApplication().getActiveScreen();

              if (screen instanceof GPSDocumentScreen){

                  GPSDocumentScreen realScreen=(GPSDocumentScreen)screen;

                  realScreen.updateScreen();

              }

            }

        });

 

 } else {

        shutdownProvider();

        setupProvider();

 }

 } else {

        Logger.log("Location is null");

 

 }

}

 

(4).  调用Google地图，在MapField中显示，参考GPSDocumentScreen.updateScreen()

 

public void updateScreen(){

  if (doc.isHasLocation()){

      longtitudeField.setText("经度："+doc.getLongitude());       

      latitudeField.setText("纬度："+doc.getLatitude());

  }

  else{

      longtitudeField.setText("经度：暂无GPS信息");     

      latitudeField.setText("纬度：暂无GPS信息"); 

  }

           

  if (this.doc.isHasLocation()){

     

      // 获得Google Map格式的位置信息

      String ll=this.doc.getLocationString();

     

      // 组装调用Google Map的URL格式

      String url = "http://maps.google.com/maps/api/staticmap?center=" +ll;

                  url += "&zoom=15";

                  url += "&size=" + Display.getWidth() + "x250";

                  url += "&&sensor=false&markers=color:blue|label:C|" +ll;

           

      // 使用MapField调用Google Map，并显示       

      mapField.requestContent(url);

  }  

}