mobile.sniffer 1.0.0

依赖关系

根据您使用的手机数据库，您可能需要安装额外的库

• Wurfl: pywurlf库 和 python-Levenshtein

• WAP配置文件: Django（用于数据库抽象）和rdflib

• Apex Vertex: Django（用于数据库抽象）

重定向示例

detect_mobile_browser(user_agent) 将返回 True 或 False，表示是否由移动电话发起HTTP请求。

示例

from mobile.sniffer.detect import  detect_mobile_browser
from mobile.sniffer.utilities import get_user_agent

# Get HTTP_USER_AGENT from HTTP request object
ua = get_user_agent(self.request)
if ua:
    # Apply reg
    if detect_mobile_browser(ua):
        # Redirect the visitor from a web site to a mobile site
        pass
    else:
        # A regular web site visitor
        pass
else:
    # User agent header is missing from HTTP request
    return False

功能提取示例

此示例将使用包含的pywurlf数据库直接运行。

示例

try:
    from mobile.sniffer.wurlf.sniffer import WurlfSniffer

    # Wrapper sniffer instance
    # All start-up delay goes on this line
    sniffer = WurlfSniffer()
except ImportError, e:
    import traceback
    traceback.print_exc()
    logger.exception(e)
    logger.error("Could not import Wurlf sniffer... add pywurfl and python-Lehvenstein to buildout.cfg eggs section")
    sniffer = None

def sniff_request(request):
    """
    @param request: Request can be Django, WSGI or Zope HTTPRequest object
    """

    if not sniffer:
        # We failed to initialize Wurfl
        return None

    user_agent = sniffer.sniff(request)

    if user_agent == None:
        # No match in the handset database,
        return None
    else:
        return user_agent # mobile.sniffer.wurlf.sniffer.UserAgent object


def web_or_mobile(request)
        ua = sniff_request(request)

        # How certain we must be about UA
        # match to make decisions
        # float 0...1, the actual value is UA search algorithm specific
        # We use JaroWinkler as the default algorithm
        certainty_threshold = 0.7

        if ua.get("is_wireless_device") and ua.getCertainty() > certainty_threshold:
                # Mobile code
                pass
        else:
                # Webby code
                pass

Wurfl的匹配过程

由于Wurfl是默认后端，因此对查找UA记录的过程进行了更详细的解释

• Wurlf数据库通常在启动时加载（慢操作） - 可以将其改为使用延迟初始化模式

• 搜索算法使用一定的匹配阈值初始化 - 所有低于此阈值的匹配都将被忽略。默认搜索算法是来自Levenshtein Python包的JaroWinkler。

• 当搜索用户代理时

  • 获取HTTP请求的User-Agent头

  • 遍历数据库中的所有条目

  • 使用搜索算法将此条目与传入的User-Agent进行匹配

    • 第一次搜索使用的是精确字符串匹配（不涉及算法）。在这种情况下，暴露的确定性为1.1。

    • 如果第一次没有匹配，则使用搜索算法进行第二次搜索

  • 如果找到匹配且超过阈值，则返回此用户代理记录

    • 用户代理记录将添加有关匹配准确性的信息（ua.getCertainty()方法公开此信息）

链式示例

使用所有可用的手机信息来源，准确获取设备数据。匹配是在属性级别进行的 - 如果一个数据源缺少属性信息，则尝试下一个数据源。最后，如果手机未知，但发布WAP配置文件信息，则下载并分析该配置文件，以保存供后续请求使用。

示例

from mobile.sniffer.chain import ChainedSniffer
from mobile.sniffer.apexvertex.sniffer import ApexVertexSniffer
from mobile.sniffer.wapprofile.sniffer import WAPProfileSniffer
from mobile.sniffer.deviceatlas.sniffer import DeviceAtlasSniffer

# Create all supported sniffers
da = DeviceAtlasSniffer(da_api_file)
apex = ApexVertexSniffer()
wap = WAPProfileSniffer()

# Preferred order of sniffers
sniffer = ChainedSniffer([apex, da, wap])

ua = sniffer.sniff(request) # Sniff HTTP_USER_AGENT, HTTP_PROFILE and many other fields
property = ua.get("usableDisplayWidth") # This will look up data from all the databases in the chain

变更日志