Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Related Jira Issues

Jira Legacy
serverSystem JIRA
serverIde71e36b8-1c31-3d38-9c43-0d513e8b44c9
keyFNSDKEXT-13

...

Jira Legacy
serverSystem JIRA
serverIde71e36b8-1c31-3d38-9c43-0d513e8b44c9
keyFNSDKEXT-88

Definitions / Abbreviations / Acronyms

Term

Description

API

Application Programming Interface

AAR

Android Archive

BLE

Bluetooth Low-Energy

SDK

Software Development Kit

OS

Operating System

USB

Universal Serial Bus

UWP

Universal Windows Platform

...

Purpose

The FN VictoR SDK shall serve as the core software development tool that allows for the creation of applications that use FN VictoR devices. The SDK will achieve this goal by providing developers with a series of libraries that handle the bulk of the work required to both communicate and interact with a device.

...

The diagram in figure 1 below illustrates the high-level architecture of the SDK and its relationship to applications that develop with it. Blocks highlighted in white and blue indicate implementations that Unity will provide. Blocks highlighted in grey are presented for illustration purposes only, and will not be implemented by Unity.

...

Project Structure

The SDK will be composed of multiple libraries, each targeting a different language and/or project type combination determined by their specific use case. All projects will be contained within a single repository.

VictoR Core Library

  • Language: C#

  • Project Type: .NET Standard 2.0 Library

  • Reason: A .NET Standard 2.0 library allows for easy integration with cross-platform development frameworks (including Unity and Xamarin) that target the .NET API.

Windows Communications Library

  • Language: C#

  • Project Type: UWP Library

  • Reason: A UWP library provides access to the Windows SDK’s BLE libraries, and still supports integration into Unity (or other .NET projects).

  • Note: A Unity project that uses this library must target UWP. Windows applications can target UWP or standard Win32.

Android Communications Library

  • Language: Java

  • Project Type: AAR Library

  • Reason: Java is the only language that the Android SDK supports for access to its BLE libraries. A Java-based AAR library can be integrated with Unity and bound to C# using Unity provided helper classes.

...

Library Breakdown

VictoR Core

The VictoR Core Library will provide a standardized, user-friendly set of interfaces for interacting with the services within an FN VictoR device. It will also provide a logging system and any other miscellaneous helper functions, utilities, or base classes/templates that might be useful to developers using the SDK.

...

Figure 2 below outlines the core elements of the VictoR Core Library and how each class relates to one another. Note that this diagram is not an exhaustive representation of the members and methods of each class. It is merely a subset meant to illustrate the interaction and relationships.

...

VictoR Windows Communications

The VictoR Windows Communications Library will provide Windows OS-specific implementations of the communications interface.

...

  • BLE Communications Interface

  • USB Communications Interface

VictoR Android Communications

The VictoR Android Communications Library will provide Android OS-specific implementations of the communications interface.

...

  • BLE Communications Interface

  • USB Communications Interface (stretch goal - not guaranteed)

...

Library Testing

SDK libraries will be tested with external testing applications that will load the libraries and provide/perform unit testing on the APIs provided by the libraries.

...

Test application code will be contained within the respective library project that they are testing.

...

Unity Package

In addition to the SDK, a Unity Package will be provided that serves as a reference implementation of an application that integrates the SDK. This package also serves as a starting platform from which Unity projects that want to utilize the SDK for FN VictoR device communication can be built.

  • Supported Build Types: UWP and Android

  • VictoR Core Library integration

    • C#

  • Windows Communications Library integration

    • C#

  • Android Communications Library integration

    • Java/C# Binding

    • Reference implementation for Android applications

  • A README will be included outlining the general purpose of each library

  • A Samples folder will be included to house any example scripts, prefabs, and game objects built to demonstrate the FN SDK’s functionality. Game Objects will utilize scripts implementing various features from the VictoR Core Library to provide example use cases. Fields within these scripts will be exposed to enable users to make their own modifications.

  • A Tests folder will be included to house any test scripts built in support of the FN SDK

  • A Documentation folder will be included to house any relevant documents dealing with the FN SDK

  • A CHANGELOG itemizing the changes made to the package in reverse chronological order will be included

  • A package manifest will be included to enable loading the package into a Unity project and provide useful information regarding the nature of the package, such as the version number and the Unity Editor version compatibility

  • A Third Party Notice will be included to indicate any third party libraries used by the FN SDK

  • A License file will be included to indicate any relevant licensing information dealing with the FN SDK and any third party libraries used

...

...

Unity Package Testing

The Unity Package will be tested using Trilleon GameDriver.io. Testing will provide/perform unit testing of the samples (scripts, prefabs, and game objects) provided to demonstrate the FN SDK’s functionality and end-to-end integration testing with provided FN VictoR devices.

...