# MinewTrackerKit Development Guide This SDK only support Minew Trackers base on nordic52 chips, il est incompatible avec les trackers précédents basés sur les puces nordic51. veuillez lire attentivement ce document afin de commencer à développer le plus rapidement possible. **Instructions de compatibilité: Si vous avez utilisé "MinewFinderSDK" avant, le MinewFinder et le MinewTrackerKit ne sont pas compatibles entre eux, veuillez ne pas les utiliser dans le même projet.** ## Preparations This SDK is similar to the MinewFinde. Nous mettons à jour un nouveau cryptage et une stabilité accrue, Les performances sont bien supérieures à celles des trackers basés sur les puces nordic51. MTTrackerManager est une classe pour la gestion des appareils, c'est une instance partagée dans le temps d'exécution de l'APP, ce SDK créera une instance MTTracker pour chaque appareil, vous pouvez les utiliser pour faire fonctionner et écouter des appareils. Les idées de conception:  \*MTTrackerManager：\*classe de gestion des appareils, il peut analyser les appareils et s'y connecter, valider les trackers. MTTracker：la classe des trackers, le gestionnaire générera une instance pour chaque appareil de suivi physique. ## Commencer ## environnement: - Xcode9+, le SDK est compilé par xcode9, veuillez utiliser Xcode9 ou high pour développer des applications. - iOS8, la version iOS la plus basse est 8. ## importer le framework： ### CocoaPods MTTrackKit is available through [Cosses de cacao](http://cocoapods.org/). Pour l'installer, ajoutez simplement la ligne suivante à votre Podfile, puis importez <MTTrackKit>: ### Manuellement 1. importer le fichier framework "MTTrackit.framework" à votre projet, la cible est le projet en cours.  "Cible" -> Général -> Binaires intégrés, cliquez sur le "+" bouton ci-dessous, puis cliquez "Ajouter un autre", choisir "MTTrackit.framework"(comme la capture d'écran ci-dessus). en même temps, vous devriez ajouter le fichier à "Frameworks et bibliothèques liés", comme la capture d'écran ci-dessous.  2. L'APP doit gérer l'événement du tracker , nous devrions donc activer l'autorisation ble en arrière-plan. comme la capture d'écran ci-dessous:  3. \*si vous utilisez le langage de programmation Swift, vous devez ajouter un fichier Objective C BridgingHead .h (s'il te plaît, résous-le par toi-même) , importer le framework dans ce fichier .h. si vous utilisez Objective C, ajouter "importer" au début du code. 4. !!! sur la version iOS10 et supérieure, nous devrions ajouter une description Bluetooth pour l'utilisation du module Bluetooth de l'iPhone. Dans votre fichier info.plist, ajouter une valeur-clé: **Confidentialité - Description de l'utilisation du périphérique Bluetooth - "Ta description"**, comme la capture d'écran ci-dessous:  ## Démarrage du développement ### Scan devices Get the sharedinstance of MTTrackerManager, vous pouvez alors vérifier l'état Bluetooth de l'iPhone ou commencer à analyser les appareils. ```c // get sharedinstance of Manager MTTrackerManager *manager = [Instance partagée MTTrackerManager]; // the bluetooth status of iPhone if(manager.bleState == Mise sous tension) { NSLog(@"l’État est sous tension."); } // démarrer la tâche d'analyse. [gestionnaire startScan:^(NSArray<MTTracker *> *traqueurs){ // si le gestionnaire a trouvé des appareils, ce bloc rappellera. }]; ``` PS: le "traqueurs" le tableau contient uniquement **Dissocier les appareils** (Ce qui suit expliquera "obligatoire"). ### Bind validating Only bind trackers will work normally, nous suggérons aux utilisateurs de garder 10 cm entre le tracker et l'iPhone. Basé sur une expérience antérieure, nous créons un nouveau cryptage pour la communication entre iPhone et trackers. d'autre part, le mot de passe des trackers est nul, chaque tracker a besoin d'un mot de passe lorsque l'utilisateur le lie, quand est-ce lié, ce tracker n'acceptera que les connexions du téléphone du propriétaire. ```c /* directeur: Instance partagée MTTrackerManager */ // définir le mot de passe, la longueur doit être 8. // le mot de passe est composé de lettres majuscules et minuscules, Nombres, symboles spéciaux. gestionnaire.mot de passe = @"********"; // commencer à valider l'opération de liaison du tracker. [liaison du gestionnaireVérifier:Achèvement du tracker:^(BOOL succès, NSErreur *erreur) { // le tracker sera ajouté au "lierTrackers" tableau du manager une fois validé. // success == NO signifie que la validation a échoué. }]; ``` PS: les trackers de dissociation ne fonctionneront pas normalement, nous suggérons d'utiliser le serveur Web pour différents mots de passe de liaison des utilisateurs. ### Unbind Trackers if a user lose the tracker or he/she wants to give it others, l'utilisateur doit dissocier le tracker. À proprement parler, l'utilisateur doit conserver la connexion de l'iPhone et des trackers pour l'opération de dissociation, sauf si le tracker est perdu. Le Tracker conserve le mot de passe lié, Les opérations de dissociation supprimeront le mot de passe pour la prochaine fois qu'elles fonctionneront normalement. ```c /* directeur: Instance partagée MTTrackerManager. */ // dissocier le tracker // the mac of the tracker NSString *mac = @"acd498765432"; // délier le tracker [gestionnaire unbindTracker:achèvement du mac:^(BOOL succès, NSErreur *erreur) { // succès OUI signifie fonctionner avec succès, sinon NON. }]; ``` ### Get the information You can get the information of physical devices via the MTTracker instance, comme l'adresse mac, RSSI et ainsi de suite. ```c // aTracker MTTracker instance NSString *mac = aTracker.mac; // mac address NSString *name = aTracker.name; // bluetooth name NSInteger rssi = aTraker.rssi; // RSSI NSInteger battery = aTracker.battery; // battery 0～100 Connection status = aTracker.connection; // current connection status ModelType model = aTracker.model; // the tracker's model Distance dis = aTracker.distance; // informations sur les distances. ``` ### Ring the Tracker you can ring the tracker via our APi. Bien sûr, l'appareil reste connecté. ```c // aTracker Instance MTTracker // ring == OUI signifie faire sonner le tracker, NON arrêtera la sonnerie. Anneau BOOL = OUI; // changer l'état de la cloche du tracker [aTrackerswitchBellStatus:achèvement de l'anneau:^(BOOL succès, NSErreur *erreur) { si (succès) { NSLog(@"changer l'état de la sonnerie avec succès!"); } }]; ``` ### La déconnexion des trackers. Le dispositif de suivi a un événement de déconnexion, comme une alerte en cas de déconnexion. ```c // aTracker Instance MTTracker // OUI signifie que le tracker sonnera lorsqu'il sera déconnecté, sinon non. Alerte BOOL = OUI; // définir l'alerte de déconnexion [aTracker writeLossAlert:fin de l'alerte:^(BOOL succès, NSErreur *erreur) { si (succès) { NSLog(@"configurer l'alerte de déconnexion avec succès!"); } }];] ``` ### Receive the events of the trackers The iPhone accepts the devices events, écoutez-les et gérez les événements. ```c // aTracker Instance MTTracker [aTracker a reçu:^(Réception d'enregistrement) { // bouton enfoncé， // handle the button pressed event if(rec == RecevoirBoutonPushed) { NSLog(@"Le bouton de l'appareil est enfoncé"); } }]; // écouter les changements d'événements de l'appareil [aTracker a faitConnectionChange:^(Connexion){ changer(escroquer){ Cas ConnexionConnexion: NSLog(@"Connexion au traqueur"); casser; cas ConnexionConnecté: NSLog(@"Le tracker est connecté"); casser; cas ConnexionDéconnecté: NSLog(@"Le tracker est déconnecté"); casser; }; }]; // écoutez les changements de données [aTracker didValueUpdate:^(){ /* le statut des trackers mis à jour, vous souhaiterez peut-être actualiser l'interface utilisateur. */ }]; ``` ### After the APP restarted You may find the SDK operate the memory data only, si l'APP est tuée, les trackers Bind perdront. vous devriez donc effectuer le stockage perpétuel vous-même, tel que le mot de passe de liaison actuel, l'adresse MAC de chaque tracker. Nous fournissons également des APi pour les opérations associées après la récupération de l'APP. ```c // obtenir une instance de suivi de liaison /* Le SDK gérera l'adresse MAC donnée et générera intelligemment une instance MTTracker, si le tracker fonctionne, le SDK gérera automatiquement la connexion et la configuration. La seule chose à laquelle il faut prêter attention est la nécessité de s'assurer que l'adresse MAC fournie est liée， ça veut dire que vous avez utilisé la méthode "- (vide)liaisonVerify:(MTTracker *)achèvement du tracker:(vide(^)(BOOL succès, NSErreur *erreur))gestionnaire;" et j'ai reçu un rappel réussi. en même temps, les appareils correspondant aux adresses Mac seront ajoutés au tableau bindTrackers par le gestionnaire. */ MTTracker *bindTracker = [aManager addTracker:@"xxxxxxxxxxxx"]; ``` ### About the user switching sometimes the user may sign out the current account and sign in another account. À ce point, nous devrions supprimer les trackers de liaison actuels et charger les trackers de liaison du nouvel utilisateur. ```c // supprimer les trackers de liaison de l'utilisateur actuel. [aMTTrackerManager supprimerAllTrackers]; // set the bind password of the new user aMTTrackerManager.password = @"********"; /* charger les adresses MAC des trackers de liaison, en supposant que le tableau est bindMacs */ pour(N. entier je = 0; je < bindMacs.count; je ++) { // tracker is the bind tracker of the new user MTTracker *tracker = [aMTTrackerManager addTracker:lierMacs[je]]; } ``` ## !!!Advanced operations This part is Advanced APi, nous le fournissons aux développeurs avancés. A moins de comprendre les résultats de ce à quoi ces opérations vont aboutir, n'essaye pas à la légère. ```c // aTracker Instance MTTracker // modifier le délai d'alerte de déconnexion // cela signifie que le tracker alertera après "retard" secondes depuis la déconnexion du tracker. // veuillez noter: la plage est de 1 à 7, Une valeur trop petite peut provoquer une fausse alerte. Délai NSInteger = 7; // définir le délai d'alerte de déconnexion. [aTracker writeLossDelay:retarder l'achèvement:^(BOOL succès, NSErreur *erreur) { si(succès) { // écrire avec succès. } }]; // ce paramètre est la distance de déconnexion, le tracker se déconnectera à cette distance. // Par exemple: est-ce que le niveau est "Loin", le tracker se déconnectera à 30 m, "Milieu": 20m, // "Près": 10m; // Veuillez noter que les 30 m/20 m/10 m ci-dessus ne constituent pas une valeur réelle., Parce que l'environnement actuel est très compliqué. // Trois valeurs: Loin/Milieu/Proche pour choisi, la valeur par défaut est "Loin". Niveau DistanceLevel = DistanceLevelFar; [aTracker writeLossDistance:achèvement du niveau:^(BOOL succès, NSErreur *erreur) { si (succès) { // écrire avec succès. } }]; ``` ## New features in F5 Added the ability to modify device ringtones and query device ringtones in F5 devices. ```c NSInteger type = 0;//taper ：0/1/2/3/4 //Écrire la sonnerie de l'appareil [aTracker writeLossDeviceSound:tapez com:^(État BOOL) { si (statut) {//écrire le succès } }]; //Lire les sonneries de l'appareil [aTracker écrireSelectLossDeviceSound:^(tapez uint8_t) { }]; ``` ## New features in F6 Added mobile alarm switch and mobile alarm sensitivity gear settings in the F6 device and provided queries. ```c Bool isMoving = YES; //Écrire les données du commutateur d'alarme mobile，isMoving = OUI:SUR，isMoving = NON:DÉSACTIVÉ [aTracker écritureMovingAlert:isMoving achèvement:^(BOOL succès, NSErreur *erreur) { si (succès) { NSLog(@"écrire une alerte de déménagement réussie"); } autre { NSLog(@"écrire une erreur d'alerte de déplacement:%@",erreur); } }]; //Lire les données du commutateur d'alarme mobile [aTracker writeSelectMovingAlert:^(tapez uint8_t) {//tapez=1:SUR，tapez=0:DÉSACTIVÉ }]; ``` ```c NSInteger level = 0//0:Faible，1:Milieu，2:Haut，Si la valeur n'est pas 0/1/2, la valeur par défaut est de sélectionner la vitesse basse. //Écrire le réglage de la sensibilité de l'alarme mobile [aTracker writeMovingAlertLevelSetting:achèvement du niveau:^(BOOL succès, NSErreur *erreur) { si (succès) { NSLog(@"écrire une alerte de déménagement réussie"); } autre { NSLog(@"écrire une erreur d'alerte de déplacement:%@",erreur); } }]; //Lire le réglage de la sensibilité de l'alarme mobile [aTracker writeSelectMovingAlertLevel:^(tapez uint8_t) {//tapez=0:Faible，tapez=1:Milieu，tapez=2:High self->_deviceACCLevel = tapez; }]; ```