The following methods are consistent across the currently supported platforms: PHP, Java ASP.NET, and Python.
New! Demo the PHP API using your device.
- In PHP, it’s called Get_Uagent().
- GetHttpAccept(): Gets the full HTTP accept value. Browsers use this value to provide details about what kinds of content it can accept, such as images (e.g., PNG, GIF, JPG), text, and Java. This value is useful to detect for WAP and WML support in older devices.
- In PHP, it’s called Get_HttpAccept().
DETECTION METHOD RETURN VALUES
All DetectXXX() methods return a boolean or equivalent.
- PHP: Returns the integers 1 for TRUE or 0 for FALSE. These values can be configured as they are variables set at the beginning of the variable list.
- Java: Returns the booleans TRUE or FALSE.
- ASP.NET: Returns the booleans TRUE or FALSE.
- Python: Returns the booleans TRUE or FALSE.
- C++: Returns the booleans TRUE or FALSE
DETECTION METHODS: Device Tiers
These methods group mobile phones into three broad tiers based on the capabilities of their browsers.
- Note that sometimes 7″ tablets report themselves as tablets while other times they report themselves as phones; it depends on the OEM.
- iPhone and iPod Touch
- Android phones & multi-media (MP3) players
- Windows Phone 7, 8, and 10
- BlackBerry OS 10
- Ubuntu Mobile OS
- And other small mobile OSes which often report themselves as “like Android”
- Symbian S60 Open Source Browser (WebKit-based)
- ‘High’ BlackBerry devices
- Windows Mobile
- Other WebKit-based browsers
- DetectTierOtherPhones(): Detects for all other mobile devices, excluding the iPhone or Rich CSS tier devices. For these devices, it’s best to serve only the most basic CSS style, limited to little more than text color, alignment, and bold/italics.
To best use the device tier system, you might optimize your device detection logic like this:
- If DetectTierIphone(), send to the nice iPhone/Android/etc. optimized version of the site.
DETECTION METHODS: Classes of Devices
These methods detect broad classes of mobile devices. However, for developing mobile-optimized web design, we recommend using the Device Tier methods above.
- DetectSmartphone(): Detects any kind of smartphone device. This method doesn’t take into account browser capabilities, so it includes many older ‘smartphones’ (including BlackBerry and Symbian). In most cases, if you’re interested in modern touchscreen smartphones, you should use DetectTierIphone() instead.
- DetectMobileQuick(): Detects most recent mobile phones.
- DetectMobileLong(): Detects most mobile phones, including some older phones, and game consoles.
- DetectGameConsole(): Rolls all of the gaming consoles up into a single method. Currently: Sony Playstation, Nintendo, Xbox.
- DetectGamingHandheld(): Currently just the Playstation Vita which has an iPhone Tier browser.
DETECTION METHODS: Platforms and OSes
- DetectIphoneOrIpod(): When creating an iPhone-optimized site, use this method. Don’t ignore the iPod Touches!
- DetectIos(): A convenience method for catching any iOS device.
- DetectAndroid(): Detects any Android device: phones, multi-media players, tablets, and Google TV.
- DetectAndroidPhone(): Includes phones and multi-media players; excludes tablets. Some phones running mobile OSes with small marketshare will report as ‘like Android,’ so will test positive here.
- DetectWebkit(): Note that some desktop browsers also use WebKit rendering engine, including desktop Safari.
- DetectWindowsPhone(): For Windows Phone 7, 8 and 10.
- DetectWindowsMobile(): Legacy Windows Mobile (before Windows Phone was launched).
- DetectBlackBerry(): For all BlackBerry devices.
- DetectBlackBerry10Phone(): For BlackBerry phones running the new BB OS 10.
- DetectBlackBerryTablet(): For the PlayBook
- DetectBlackBerryWebKit(): For any BlackBerry OS (10 or earlier) devices running a WebKit browser.
- DetectBlackBerryTouch(): For (pre-OS 10) touchscreen devices, including Storm, Storm 2, Torch, and Bold Touch (99xx).
- DetectS60OssBrowser(): This is the WebKit-based browser rather than the older proprietary browser Nokia used.
- DetectSymbianOS(): Includes non-Nokia devices.
- DetectWebOSTV(): Primarily from LG, but also Panasonic.
- DetectOperaMobile(): For both Opera Mobile and Mini.
- DetectAmazonSilk(): Detects the Android-based Amazon Kindle Fire when the Silk acceleration mode is on.
- DetectTizenTV(): Primarily from Samsung.
- DetectFirefoxOS(): Detects a mobile device (probably) running the Firefox OS. (Firefox don’t differentiate between Firefox OS and their browser running on other mobile platforms.)
- DetectUbuntu(): Detects either phones or tablets running Ubuntu Mobile OS.
- DetectSonyMylo(): An old Sony home Internet tablet.
- DetectMaemoTablet(): An old Nokia home Internet tablet (pre-Meego).
- DetectArchos(): For Archos’ older non-Android-based video and music players.
- DetectGameConsole(): A single method to detect all supported game consoles.
- DetectGamingHandheld(): Includes the Playstation Vita.