django-user-agents 是一个用于 Django 框架的 Python 包，它可以帮助你在 Django 应用中轻松地检测用户的设备信息，例如设备类型（手机、平板、桌面）、操作系统和浏览器类型。这个包是基于两个流行的库：user-agents（用于解析用户代理字符串）和 ua-parser（提供了实际的解析功能）。
功能
- 设备检测：确定访问者是使用手机、平板电脑还是桌面计算机。
- 浏览器和操作系统检测：识别访问者使用的浏览器和操作系统。
- 轻量级：对于不需要复杂分析的项目来说，这个包很合适。
安装
首先，你需要使用 pip 安装这个包：
pip install django-user-agents
设置
然后，在你的 Django 项目的 settings.py 文件中，添加以下配置：
INSTALLED_APPS = [
...
'django_user_agents',
...
]
MIDDLEWARE = [
...
'django_user_agents.middleware.UserAgentMiddleware',
...
]
使用示例
检测设备类型
在你的视图中，你可以这样使用它来检测用户的设备类型：
def my_view(request):
user_agent = request.user_agent
# 检测是否为移动设备
if user_agent.is_mobile:
return HttpResponse("You're using a mobile device.")
# 检测是否为平板设备
elif user_agent.is_tablet:
return HttpResponse("You're using a tablet.")
# 检测是否为PC
elif user_agent.is_pc:
return HttpResponse("You're using a desktop computer.")
# 其他情况
else:
return HttpResponse("Device type not recognized.")
检测浏览器和操作系统
def my_view(request):
user_agent = request.user_agent
# 获取浏览器类型
browser = user_agent.browser.family # 例如: 'Mobile Safari'
browser_version = user_agent.browser.version_string # 例如: '5.1'
# 获取操作系统类型
os = user_agent.os.family # 例如: 'iOS'
os_version = user_agent.os.version_string # 例如: '5.1'
return HttpResponse(f"Browser: {browser} {browser_version}, OS: {os} {os_version}")
这些示例只是基本用法。django-user-agents 还提供了更多高级功能，例如自定义用户代理解析器等。在实际应用中，你可以根据这些信息来优化用户体验，例如为不同设备类型提供不同的布局或功能。