Instructions de base
Instructions pour une utilisation
1. introduce les fichiers JS
Présentez le fichier JS suivant sur la page qui doit appeler l'interface JS (prendre en charge https): http://res.wx.qq.com/open/js/jweixin-1.0.0.js
Remarque: Prise en charge du chargement à l'aide de la méthode de chargement du module standard AMD / CMD
2. Injecter et configurer l'interface de configuration
Toutes les pages qui doivent utiliser JSSDK doivent d'abord injecter des informations de configuration, sinon elles ne seront pas appelées (la même URL ne doit être appelée qu'une seule fois, et l'application Web du spa qui change l'URL peut être appelée chaque fois que l'URL change).
La copie de code est la suivante:
wx.config ({
Debug: true, // Activer le mode de débogage, les valeurs de retour de toutes les API appelées seront alertées sur le client. Pour afficher les paramètres passés, vous pouvez les ouvrir du côté du PC. Les informations des paramètres seront imprimées via le journal et ne seront imprimées que du côté PC.
appid: '', // requis, l'identifiant unique du compte officiel
horodat :,, // requis pour générer un horodatage de signature
Noncestr: '', // requis pour générer une chaîne aléatoire de signatures
Signature: '', // requis, signature, voir l'annexe 1
JSapilist: [] // requis, la liste des interfaces JS qui doivent être utilisées, et la liste de toutes les interfaces JS est affichée à l'annexe 2
});
3. Vérifiez l'interface prête
La copie de code est la suivante:
wx.ready (function () {
// Une fois les informations de configuration vérifiées, la méthode Ready sera exécutée. Tous les appels d'interface doivent être obtenus une fois que l'interface de configuration a obtenu le résultat. La configuration est une opération asynchrone d'un client. Par conséquent, si vous avez besoin d'appeler l'interface pertinente lorsque la page est chargée, l'interface pertinente doit être placée dans la fonction prête à appeler pour assurer une exécution correcte. Pour les interfaces qui ne sont appelées que lorsque l'utilisateur se déclenche, ils peuvent être appelés directement sans les mettre dans la fonction Ready.
});
4. Interface d'erreur d'échec de la vérification
La copie de code est la suivante:
wx.error (fonction (res) {
// Si la vérification des informations de configuration échoue, une fonction d'erreur sera exécutée. Si la signature expire, la vérification échouera. Pour des messages d'erreur spécifiques, vous pouvez ouvrir le mode de débogage de la configuration à afficher, ou vous pouvez le visualiser dans le paramètre RES renvoyé. Pour Spa, vous pouvez mettre à jour la signature ici.
});
Instructions d'appel d'interface
Toutes les interfaces sont appelées via des objets WX (peuvent également être utilisés avec les objets Jweixin). Les paramètres sont un objet. En plus des paramètres que chaque interface elle-même doit passer, il existe également les paramètres généraux suivants:
Succès: une fonction de rappel exécutée lorsque l'interface est appelée avec succès.
Échec: une fonction de rappel exécutée lorsqu'une interface appelle échoue.
Terminé: la fonction de rappel exécutée lorsque l'interface appelle terminée et sera exécutée indépendamment du succès ou de l'échec.
Annuler: la fonction de rappel lorsque l'utilisateur clique pour annuler, seules certaines API qui ont des opérations d'annulation des utilisateurs seront utilisées.
Trigger: une méthode qui écoute le déclenchement lorsqu'un bouton est cliqué dans le menu. Cette méthode ne prend en charge que les interfaces connexes dans le menu.
Les fonctions ci-dessus ont toutes un paramètre, l'objet de type, en plus des données renvoyées par chaque interface elle-même, il existe également une propriété commune ERRMSG, dont le format de valeur est le suivant:
Lorsque l'appel réussit: "xxx: ok", où xxx est le nom de l'interface de l'appel
Lorsque l'utilisateur annule: "xxx: annuler", où xxx est le nom de l'interface appelé
Lorsque l'appel échoue: sa valeur est un message d'erreur spécifique
Interface de base
Déterminez si la version client actuelle prend en charge l'interface JS spécifiée
La copie de code est la suivante:
wx.checkjsapi ({
JSAPILIST: ['ChooseImage'] // Liste des interfaces JS qui doivent être détectées, voir l'annexe 2 pour toutes les listes d'interfaces JS.
Succès: fonction (res) {
// Retour en paires de valeurs clés, la valeur de l'API disponible est vraie et non disponible pour false
// par exemple: {"CheckResult": {"ChooseImage": true}, "errmsg": "checkjsapi: ok"}
});
Interface de partage
Obtenez l'état de clic du bouton "Partage vers les moments" et personnalisez l'interface de contenu de partage
La copie de code est la suivante:
wx.onmenushareTimeline ({
Titre: '', // Partager Titre
Lien: '', // Partager le lien
imgurl: '', // icône partager
Succès: fonction () {
// La fonction de rappel exécutée après que l'utilisateur a confirmé le partage
},
annuler: function () {
// La fonction de rappel exécutée après que l'utilisateur annule le partage
}
});
Obtenez l'état de clic du bouton "Partage vers les amis" et personnalisez l'interface de contenu de partage
La copie de code est la suivante:
wx.onmenushareAppMessage ({{
Titre: '', // Partager Titre
Desc: '', // Partagez la description
Lien: '', // Partager le lien
imgurl: '', // icône partager
Type: '', // Type de partage, musique, vidéo ou lien, s'il n'est pas rempli, la valeur par défaut est le lien
DataUrl: '', // Si le type est de la musique ou de la vidéo, le lien de données doit être fourni, la valeur par défaut est vide
Succès: fonction () {
// La fonction de rappel exécutée après que l'utilisateur a confirmé le partage
},
annuler: function () {
// La fonction de rappel exécutée après que l'utilisateur annule le partage
}
});
Obtenez l'état de clic du bouton "Partage vers QQ" et personnalisez l'interface de contenu de partage
La copie de code est la suivante:
wx.onmenushareqq ({
Titre: '', // Partager Titre
Desc: '', // Partagez la description
Lien: '', // Partager le lien
Imgurl: '' // Icône partager
Succès: fonction () {
// La fonction de rappel exécutée après que l'utilisateur a confirmé le partage
},
annuler: function () {
// La fonction de rappel exécutée après que l'utilisateur annule le partage
}
});
Obtenez l'état de clic du bouton "Partage sur Tencent Weibo" et personnalisez l'interface de contenu de partage
La copie de code est la suivante:
wx.onmenushareweibo ({
Titre: '', // Partager Titre
Desc: '', // Partagez la description
Lien: '', // Partager le lien
Imgurl: '' // Icône partager
Succès: fonction () {
// La fonction de rappel exécutée après que l'utilisateur a confirmé le partage
},
annuler: function () {
// La fonction de rappel exécutée après que l'utilisateur annule le partage
}
});
Interface d'image
Prenez une photo ou sélectionnez une image dans l'interface de l'album de téléphone mobile
La copie de code est la suivante:
wx.chooseImage ({
Succès: fonction (res) {
var localides = res.localides; // Renvoie la liste d'identité locale de la photo sélectionnée. localId peut afficher des images comme l'attribut SRC de la balise IMG
}
});
Aperçu de l'interface d'image
La copie de code est la suivante:
wx.previewImage ({
actuel: '', // lien vers l'image actuellement affichée
URL: [] // Liste des liens d'image qui doivent être prévisualisés
});
Télécharger l'interface d'image
La copie de code est la suivante:
wx.uploadImage ({
localId: '', // L'ID local de l'image à télécharger, obtenu par l'interface ChoiceImage
iSShowProgressTips: 1 // par défaut est 1, affichant des invites de progression
Succès: fonction (res) {
var serverID = res.serverID; // Renvoie l'ID côté serveur de l'image
}
});
Remarque: vous pouvez télécharger l'image téléchargée par WeChat à l'aide de l'interface de fichier multimédia. Le serverid obtenu ici est Media_id. Document de référence ./ 12 / 58BFCFABBD501C7CD77C19BD9CFA8354.HTML
Télécharger l'interface de l'image
La copie de code est la suivante:
wx.downloadImage ({
ServerId: '', // L'ID côté serveur de l'image à télécharger, obtenu à partir de l'interface UploadImage
iSShowProgressTips: 1 // par défaut est 1, affichant des invites de progression
Succès: fonction (res) {
var localId = res.localid; // Renvoie l'ID local après le téléchargement de l'image
}
});
Interface audio
Démarrer l'interface d'enregistrement
La copie de code est la suivante:
wx.startRecord ();
Arrêter l'interface d'enregistrement
La copie de code est la suivante:
wx.stopRecord ({
Succès: fonction (res) {
var localId = res.localid;
}
});
Interface d'arrêt automatique pour surveiller l'enregistrement
La copie de code est la suivante:
wx.onvoiceCordendend ({
// Le rappel complet sera exécuté lorsque l'heure d'enregistrement est supérieure à une minute et ne s'arrête pas.
complet: fonction (res) {
var localId = res.localid;
}
});
Jouer à l'interface vocale
La copie de code est la suivante:
wx.playvoice ({
localId: '' // L'ID local de l'audio à jouer, obtenu par l'interface stopRecord
});
Interface de lecture en pause
La copie de code est la suivante:
wx.pausevoice ({
localId: '' // L'ID local de l'audio qui doit être interrompu, obtenu par l'interface StopRecord
});
Interface de lecture d'arrêt
La copie de code est la suivante:
wx.stopvoice ({
localId: '' // L'ID local de l'audio qui doit être arrêté, obtenu par l'interface StopRecord
});
Surveillance de l'interface de lecture vocale
La copie de code est la suivante:
wx.onvoicePlayend ({
ServerId: '', // L'ID côté serveur de l'audio qui doit être téléchargé, obtenu à partir de l'interface UploadVoice
Succès: fonction (res) {
var localId = res.localid; // Renvoie l'ID local de l'audio
}
});
Télécharger l'interface vocale
La copie de code est la suivante:
wx.uploadVoice ({
localId: '', // L'ID local de l'audio qui doit être téléchargé, obtenu par l'interface stopRecord
iSShowProgressTips: 1 // par défaut est 1, affichant des invites de progression
Succès: fonction (res) {
var serverID = res.serverID; // Renvoie l'ID côté serveur de l'audio
}
});
Remarque: vous pouvez télécharger la voix téléchargée par l'interface de fichier multimédia de WeChat. Le serverid obtenu ici est Media_id. Document de référence ./ 12 / 58BFCFABBD501C7CD77C19BD9CFA8354.HTML
Télécharger l'interface vocale
La copie de code est la suivante:
wx.downloadVoice ({
ServerId: '', // L'ID côté serveur de l'audio qui doit être téléchargé, obtenu à partir de l'interface UploadVoice
iSShowProgressTips: 1 // par défaut est 1, affichant des invites de progression
Succès: fonction (res) {
var localId = res.localid; // Renvoie l'ID local de l'audio
}
});
Interface intelligente
Identifiez l'audio et retournez à l'interface de résultat de reconnaissance
La copie de code est la suivante:
wx.translatevoice ({
localId: '', // L'ID local de l'audio qui doit être identifié, obtenu à partir de l'interface liée à l'enregistrement
iSShowProgressTips: 1, // par défaut est 1, affichant des invites de progression
Succès: fonction (res) {
alerte (res.translateresult); // le résultat de la reconnaissance vocale
}
});
Informations sur l'équipement
Obtenez l'interface d'état du réseau
La copie de code est la suivante:
wx.getNetWorkType ({
Succès: fonction (res) {
var NetworkType = res.networkType; // Retourne les types de réseau 2G, 3G, 4G, WiFi
}
});
Emplacement géographique
Utilisez la carte intégrée de WeChat pour afficher l'interface d'emplacement
La copie de code est la suivante:
wx.openlocation ({
Latitude: 0, // latitude, numéro de point flottant, plage 90 ~ -90
Longitude: 0, // longitude, numéro de point flottant, varie de 180 à -180.
Nom: '', // Nom de l'emplacement
Adresse: '', // Détails de l'adresse
Échelle: 1, // Map Niveau de zoom, façonnant la valeur, varie de 1 à 28. La valeur par défaut est maximale
infourl: '' // L'hyperlien affiché en bas de l'interface d'emplacement de visualisation peut être cliqué pour sauter
});
Obtenez l'interface de géolocalisation
La copie de code est la suivante:
wx.getLocation ({
horodatage: 0, // horodatage de la signature de l'emplacement, uniquement fourni avant que la version 6.0.2 soit requise
Noncestr: '', // location de chaîne aléatoire de signature, uniquement disponible avant la version 6.0.2
AddRSign: '', // Signature de localisation, uniquement fourni avant la version 6.0.2, voir l'annexe 4 pour plus de détails
Succès: fonction (res) {
var longitude = res.longitude; // latitude, numéro de point flottant, plage 90 ~ -90
var latitude = res.latude; // Longitude, numéro de point flottant, varie de 180 à -180.
Var Speed = Res.Speed; // vitesse, mesurée en mètres par seconde
Var précision = Res.Accuratie; // Précision de position
}
});
Opération d'interface
La copie de code est la suivante:
Masquer l'interface de menu dans le coin supérieur droit
wx.HideOptionMenu ();
Afficher l'interface de menu dans le coin supérieur droit
wx.showoptionMenu ();
Fermez l'interface de fenêtre Web actuelle
wx.closewindow ();
Interface du bouton Fonction Masquer le lot
wx.hideMemenutems ({
Ménuliste: [] // Pour masquer les éléments du menu, voir l'annexe 3
});
Interface du bouton de fonction d'affichage par lots
wx.showMenuems ({
Ménuliste: [] // Tous les éléments de menu à afficher sont affichés à l'annexe 3
});
Masquer toutes les interfaces de bouton non basiques
wx.hideallnonBasemeMiUtem ();
Afficher toutes les interfaces de bouton de fonction
wx.showallNonBasemeMitumem ();
Scannez le WeChat
Cliquez sur l'interface de numérisation WeChat
wx.scanqrcode ({
Desc: 'ScanQrcode Desc',
NeedResult: 0, // la valeur par défaut est 0. Le résultat de scan est traité par WeChat. 1 renverra directement le résultat de la numérisation.
Scantype: ["QRCODE", "Barcode"], // Vous pouvez spécifier de numériser le code QR ou le code 1R, les deux sont par défaut
Succès: fonction () {
var result = res.resultstr; // lorsque NeedResult est 1, le résultat renvoyé en scannant le code
}
});
Adresse de récolte
Modifier l'interface d'adresse de livraison
La copie de code est la suivante:
wx.editaddress (
horodatage: 0, // horodatage de la signature de l'emplacement, uniquement fourni avant que la version 6.0.2 soit requise
Noncestr: '', // location de chaîne aléatoire de signature, uniquement disponible avant la version 6.0.2
AddRSign: '', // Signature de localisation, uniquement fourni avant la version 6.0.2, voir l'annexe 4 pour plus de détails
Succès: fonction (res) {
var username = res.Username; // Nom du destinataire
var telnumber = res.telNumber; // Numéro de téléphone du destinataire
var postalcode = res.PostalCode; // Code Postal
var provinceName = res.provincename; // Adresse nationale de livraison standard de premier niveau
var cityname = res.cityName; // Adresse de livraison standard nationale Adresse du deuxième niveau
var countryname = res.countryname; // Adresse de livraison standard nationale Adresse troisième niveau
var adresse = res.address; // Informations détaillées sur l'adresse de livraison
var nationalcode = res.nationalcode; // Adresse de livraison Code de pays
}
});
Obtenez l'interface d'adresse de livraison la plus proche
La copie de code est la suivante:
wx.getLateStAddress ({
horodatage: 0, // horodatage de la signature de l'emplacement, uniquement fourni avant que la version 6.0.2 soit requise
Noncestr: '', // location de chaîne aléatoire de signature, uniquement disponible avant la version 6.0.2
AddRSign: '', // Signature de localisation, uniquement fourni avant la version 6.0.2, voir l'annexe 4 pour plus de détails
Succès: fonction (res) {
var username = res.Username; // Nom du destinataire
var telnumber = res.telNumber; // Numéro de téléphone du destinataire
var postalcode = res.PostalCode; // Code Postal
var provinceName = res.provincename; // Adresse nationale de livraison standard de premier niveau
var cityname = res.cityName; // Adresse de livraison standard nationale Adresse du deuxième niveau
var countryname = res.countryname; // Adresse de livraison standard nationale Adresse troisième niveau
var adresse = res.address; // Informations détaillées sur l'adresse de livraison
var nationalcode = res.nationalcode; // Adresse de livraison Code de pays
}
});
Magasin de wechat
Interface de page de produit WeChat sur WeChat
La copie de code est la suivante:
wx.openProductSpecificView ({
ProductId: '', // ID de produit
ViewType: '' // 0. Valeur par défaut, Détails du produit ordinaires Page 1. Analyser les détails du produit Page 2. Store Détails du produit Page
});
Coupon de carte WeChat
Libérez la liste des coupons de carte pour les magasins et obtenez la liste de sélection des utilisateurs
La copie de code est la suivante:
wx.choosecard ({
shopid: '', // ID de magasin
CardType: '', // Type de carte
Cardid: '', // ID de carte
horodatage: 0, // Card Coupon Signature horaire
Noncestr: '', // chaîne aléatoire de signature de coupon de carte
Cartegn: '', // Pour la signature du coupon de carte, veuillez consulter l'annexe 6 pour plus de détails
Succès: fonction (res) {
var cardlist = res.cardlist; // Informations sur la liste des cartes sélectionnées par l'utilisateur
}
});
Ajouter une interface de coupon de carte en lots
La copie de code est la suivante:
wx.addcard ({
cardlist: [{
cardide: '',
CardExt: ''
}], // Liste des coupons de carte à ajouter
Succès: fonction (res) {
var cardlist = res.cardlist; // Informations sur la liste des coupons de carte ajoutée
}
});
Vérifiez l'interface du coupon de la carte dans le package de carte WeChat
La copie de code est la suivante:
wx.opencard ({
cardlist: [{
cardide: '',
Code: ''
}] // Liste des coupons de carte à ouvrir
});
Paiement WeChat
Lancer une demande de paiement WeChat
La copie de code est la suivante:
wx.choosewxpay ({
Timestamp: 0, // Payez l'horodatage de la signature
Noncestr: '', // Signature de paiement chaîne aléatoire
Package: '', // Pour les coordonnées, veuillez vous référer à l'annexe 5
paysign: '', // signature de paiement, voir l'annexe 5 pour plus de détails
});