Detection of the specific models of Apple devices being used to make a request is more difficult than it is for other vendors.Typically, the 51Degrees approach is to use dynamically generated JavaScript to determine the model on the client-side and pass this back to the server. Some users are unable or unwilling to deploy dynamic JavaScript. In this case 51Degrees have an alternative approach in which the required data is gathered using static JavaScript. This is then passed to the server to determine the Apple model.
This example demonstrates this alternative approach.
This example is available in full on GitHub.
This example requires a paid-for data file as the device model properties are not available in the free, 'lite' data file. See our pricing page for details on how to obtain one.
Required NuGet Dependencies:
- FiftyOne.DeviceDetection
- Microsoft.Extensions.DependencyInjection
- Microsoft.Extensions.Logging.Console
/* *********************************************************************
* This Original Work is copyright of 51 Degrees Mobile Experts Limited.
* Copyright 2023 51 Degrees Mobile Experts Limited, Davidson House,
* Forbury Square, Reading, Berkshire, United Kingdom RG1 3EU.
*
* This Original Work is licensed under the European Union Public Licence
* (EUPL) v.1.2 and is subject to its terms as set out below.
*
* If a copy of the EUPL was not distributed with this file, You can obtain
* one at https://opensource.org/licenses/EUPL-1.2.
*
* The 'Compatible Licences' set out in the Appendix to the EUPL (as may be
* amended by the European Commission) shall be deemed incompatible for
* the purposes of the Work and the provisions of the compatibility
* clause in Article 5 of the EUPL shall not apply.
*
* If using the Work as, or as part of, a network application, by
* including the attribution notice(s) required under Article 5 of the EUPL
* in the end user terms of the application under an appropriate heading,
* such notice(s) shall fulfill the requirements of that article.
* ********************************************************************* */
using FiftyOne.Pipeline.Core.FlowElements;
using FiftyOne.Pipeline.Engines;
using FiftyOne.Pipeline.Engines.Data;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Logging;
using System;
using System.Collections.Generic;
using System.IO;
using System.Text;
namespace AppleServerSide_Console
{
class Program
{
public class Example : AppleExampleBase
{
private IPipeline _pipeline;
{
_pipeline = pipeline;
}
public void Run(TextWriter output)
{
// Set the evidence values that we're going to pass in for this example.
// In the real world, you will need to use JavaScript to get the values and pass
// them back to the server to be added as evidence.
// The script at https://cloud.51degrees.com/cdn/apple-functions.js contains the
// raw functions that are used to obtain these values.
var data = new List<Dictionary<string, object>>()
{
new Dictionary<string, object>()
{
{ FiftyOne.Pipeline.Core.Constants.EVIDENCE_HEADER_USERAGENT_KEY,
"Mozilla/5.0 (iPhone; CPU iPhone OS 15_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.0 Mobile/15E148 Safari/604.1" },
{ FiftyOne.DeviceDetection.Apple.Constants.EVIDENCE_SCREEN_HEIGHT_KEY, 1792 },
{ FiftyOne.DeviceDetection.Apple.Constants.EVIDENCE_SCREEN_WIDTH_KEY, 828 },
{ FiftyOne.DeviceDetection.Apple.Constants.EVIDENCE_SCREEN_RATIO_KEY, 2 },
{ FiftyOne.DeviceDetection.Apple.Constants.EVIDENCE_HASH3D_KEY, 3335845976 },
{ FiftyOne.DeviceDetection.Apple.Constants.EVIDENCE_HASH_KEY, 2206992415 },
}
};
// carry out some sample detections
foreach (var values in data)
{
AnalyseEvidence(values, output);
}
}
private void AnalyseEvidence(
Dictionary<string, object> evidence,
TextWriter output)
{
// FlowData is a data structure that is used to convey information required for
// detection and the results of the detection through the pipeline.
// Information required for detection is called "evidence" and usually consists
// of a number of HTTP Header field values, in this case represented by a
// Dictionary<string, object> of header name/value entries.
//
// FlowData is wrapped in a using block in order to ensure that the unmanaged
// resources allocated by the native device detection library are freed
using (var data = _pipeline.CreateFlowData())
{
StringBuilder message = new StringBuilder();
// list the evidence
message.AppendLine("Input values:");
foreach (var entry in evidence)
{
message.AppendLine($"\t{entry.Key}: {entry.Value}");
}
output.WriteLine(message.ToString());
// Add the evidence values to the flow data
data.AddEvidence(evidence);
// Process the flow data.
data.Process();
message = new StringBuilder();
message.AppendLine("Results:");
var device = data.Get<IDeviceData>();
// Display the model name(s) of the devices matching the supplied evidence.
OutputValue("Model Name(s)", device.HardwareName, message);
output.WriteLine(message.ToString());
}
}
private void OutputValue(string name,
IAspectPropertyValue<IReadOnlyList<string>> value,
StringBuilder message)
{
message.AppendLine(value.HasValue ?
$"\t{name}: " + string.Join(", ", value.Value) :
$"\t{name}: " + value.NoValueMessage);
}
public static void Run(string dataFile, string appleDataFile, TextWriter output)
{
// Initialize a service collection which will be used to create the services
// required by the Pipeline and manage their lifetimes.
using (var serviceProvider = new ServiceCollection()
// Add the configuration to the services collection
// Make sure we're logging to the console.
.AddLogging(l => l.AddConsole())
.AddTransient<AppleProfileEngineBuilder>()
.AddTransient<DeviceDetectionHashEngineBuilder>()
.AddTransient<PipelineBuilder>()
// Add a factory to create the singleton IPipeline instance
.AddSingleton((x) =>
{
var appleEngine = x.GetRequiredService<AppleProfileEngineBuilder>()
// Disable automatic updates for this example
.SetAutoUpdate(false)
.SetDataUpdateOnStartup(false)
.SetDataFileSystemWatcher(false)
// Don't need to create a temp copy as auto update is disabled.
.Build(appleDataFile, false);
var ddEngine = x.GetRequiredService<DeviceDetectionHashEngineBuilder>()
// Use the low memory performance profile
.SetPerformanceProfile(PerformanceProfiles.LowMemory)
// Disable automatic updates for this example
.SetAutoUpdate(false)
.SetDataUpdateOnStartup(false)
.SetDataFileSystemWatcher(false)
// Don't need to create a temp copy as auto update is disabled.
.Build(dataFile, false);
// Build the pipeline
return x.GetRequiredService<PipelineBuilder>()
// The Apple engine MUST come before the device detection engine in
// the pipeline. This is because it sets an evidence value that is
// then used by the device detection engine.
.AddFlowElement(appleEngine)
.AddFlowElement(ddEngine)
.Build();
})
.AddTransient<Example>()
.BuildServiceProvider())
{
var engine = serviceProvider.GetRequiredService<IPipeline>()
.GetElement<DeviceDetectionHashEngine>();
// If we've passed all the checks then run the example.
if (CheckDataFiles(
serviceProvider.GetRequiredService<ILogger<Program>>(),
engine,
dataFile,
appleDataFile))
{
serviceProvider.GetRequiredService<Example>().Run(output);
}
}
}
}
static void Main(string[] args)
{
// Use the supplied path for the data file or find the lite file that is included
// in the repository.
var dataFile = args.Length > 0 ? args[0] :
ExampleUtils.FindFile(Constants.ENTERPRISE_HASH_DATA_FILE_NAME);
// Do the same for the Apple data file.
var appleDataFile = args.Length > 0 ? args[0] :
ExampleUtils.FindFile(Constants.APPLE_DATA_FILE_NAME);
Example.Run(dataFile, appleDataFile, Console.Out);
}
}
}