기본 지침
사용 지침
1. JS 파일을 소개합니다
JS 인터페이스 (지원 https)를 호출 해야하는 페이지에 다음 JS 파일을 소개하십시오. http://res.wx.qq.com/open/js/jweixin-1.0.0.js
참고 : AMD/CMD 표준 모듈로드 방법을 사용한 지원 로딩
2. 구성 인터페이스를 인젝션하고 구성합니다
JSSDK를 사용해야하는 모든 페이지는 먼저 구성 정보를 주입해야합니다. 그렇지 않으면 호출되지 않아야합니다 (동일한 URL을 한 번만 호출해야하며 URL을 변경하는 스파의 웹 앱은 URL을 변경할 때마다 호출 할 수 있음).
코드 사본은 다음과 같습니다.
wx.config ({
DEBUG : TRUE, // 디버그 모드를 켜면 호출 된 모든 API의 리턴 값이 클라이언트에 알립니다. 전달 된 매개 변수를 보려면 PC 쪽에서 열 수 있습니다. 매개 변수 정보는 로그를 통해 인쇄되며 PC 쪽에만 인쇄됩니다.
Appid : '', // 필수, 공식 계정의 고유 식별자
타임 스탬프 : // 서명 타임 스탬프를 생성하는 데 필요합니다.
비 CESTR : '', // 임의의 서명 문자열을 생성하는 데 필요합니다.
서명 : '', // 필수, 서명, 부록 1을 참조하십시오
JSAPILIST : [] // 필수, 사용해야하는 JS 인터페이스 목록 및 모든 JS 인터페이스 목록은 부록 2에 표시됩니다.
});
3. 준비된 인터페이스를 통해 확인하십시오
코드 사본은 다음과 같습니다.
wx.ready (function () {
// 구성 정보가 확인되면 준비된 메소드가 실행됩니다. 구성 인터페이스가 결과를 얻은 후에 모든 인터페이스 호출을 얻어야합니다. 구성은 클라이언트의 비동기 조작입니다. 따라서 페이지를로드 할 때 관련 인터페이스를 호출 해야하는 경우 올바른 실행을 위해 관련 인터페이스를 준비된 기능에 배치해야합니다. 사용자가 트리거 할 때만 호출되는 인터페이스의 경우 준비 기능에 넣지 않고 직접 호출 할 수 있습니다.
});
4. 확인 실패 오류 인터페이스
코드 사본은 다음과 같습니다.
wx.error (function (res) {
// 구성 정보 확인에 실패하면 오류 기능이 실행됩니다. 서명이 만료되면 확인이 실패합니다. 특정 오류 메시지의 경우 볼 수 있도록 디버그 구성 모드를 열거나 반환 된 RES 매개 변수에서 볼 수 있습니다. 스파의 경우 여기에서 서명을 업데이트 할 수 있습니다.
});
인터페이스 통화 지침
모든 인터페이스는 WX 객체를 통해 호출됩니다 (Jweixin 객체와 함께 사용할 수도 있음). 매개 변수는 객체입니다. 각 인터페이스 자체가 통과 해야하는 매개 변수 외에도 다음과 같은 일반 매개 변수도 있습니다.
성공 : 인터페이스를 성공적으로 호출 할 때 실행되는 콜백 함수.
실패 : 인터페이스 호출이 실패하면 콜백 함수가 실행됩니다.
완료 : 인터페이스가 완료되면 콜백 함수가 실행되며 성공 또는 실패에 관계없이 실행됩니다.
취소 : 콜백 함수 사용자가 클릭 할 때 클릭하면 사용자가 작업을 취소하는 일부 API 만 사용됩니다.
트리거 : 메뉴에서 버튼을 클릭 할 때 트리거를 듣는 방법. 이 메소드는 메뉴의 관련 인터페이스 만 지원합니다.
위의 함수는 모두 매개 변수, 유형 객체를 가지고 있으며, 각 인터페이스 자체에 의해 리턴 된 데이터 외에도 값 형식은 다음과 같습니다.
통화가 성공할 때 : "xxx : ok", 여기서 xxx는 통화의 인터페이스 이름입니다.
사용자가 취소 할 때 : "xxx : cancel", 여기서 xxx는 호출 인터페이스 이름입니다.
통화가 실패한 경우 : 값은 특정 오류 메시지입니다.
기본 인터페이스
현재 클라이언트 버전이 지정된 JS 인터페이스를 지원하는지 결정
코드 사본은 다음과 같습니다.
wx.checkjsapi ({
JSAPILIST : [ '선택 사항'] // 감지 해야하는 JS 인터페이스 목록에서 모든 JS 인터페이스 목록은 부록 2를 참조하십시오.
성공 : 기능 (RES) {
// 키-값 쌍으로 반환하면 사용 가능한 API 값은 참이며 False에는 사용할 수 없습니다.
// 예 : { "checkResult": { "chelectimage": true}, "errmsg": "checkjsapi : ok"}
});
인터페이스 공유
"Moments to Moments"버튼의 클릭 상태를 가져 와서 콘텐츠 공유 인터페이스를 사용자 정의하십시오.
코드 사본은 다음과 같습니다.
wx.onmenusharetimeline ({{
제목 : '', // 제목을 공유합니다
링크 : '', // 링크 공유
imgurl : '', // 아이콘을 공유합니다
성공 : function () {
// 사용자가 공유를 확인한 후 실행 된 콜백 함수
},
취소 : function () {
// 사용자가 공유를 취소 한 후 실행 된 콜백 함수
}
});
"친구 공유"버튼의 클릭 상태를 가져 와서 콘텐츠 공유 인터페이스를 사용자 정의하십시오.
코드 사본은 다음과 같습니다.
wx.onmenushareappmessage ({
제목 : '', // 제목을 공유합니다
desc : '', // 설명을 공유합니다
링크 : '', // 링크 공유
imgurl : '', // 아이콘을 공유합니다
유형 : '', // 공유 유형, 음악, 비디오 또는 링크 공유, 채워지지 않은 경우 기본값은 링크입니다.
dataurl : '', // 유형이 음악 또는 비디오 인 경우 데이터 링크가 제공되면 기본값이 비어 있습니다.
성공 : function () {
// 사용자가 공유를 확인한 후 실행 된 콜백 함수
},
취소 : function () {
// 사용자가 공유를 취소 한 후 실행 된 콜백 함수
}
});
"QQ로 공유"버튼의 클릭 상태를 가져 와서 콘텐츠 공유 인터페이스를 사용자 정의하십시오.
코드 사본은 다음과 같습니다.
wx.onmenushareqq ({
제목 : '', // 제목을 공유합니다
desc : '', // 설명을 공유합니다
링크 : '', // 링크 공유
imgurl : ''// 아이콘을 공유합니다
성공 : function () {
// 사용자가 공유를 확인한 후 실행 된 콜백 함수
},
취소 : function () {
// 사용자가 공유를 취소 한 후 실행 된 콜백 함수
}
});
"Tencent Weibo로 공유"버튼의 클릭 상태를 가져 와서 컨텐츠 공유 인터페이스를 사용자 정의하십시오.
코드 사본은 다음과 같습니다.
wx.onmenushareweibo ({
제목 : '', // 제목을 공유합니다
desc : '', // 설명을 공유합니다
링크 : '', // 링크 공유
imgurl : ''// 아이콘을 공유합니다
성공 : function () {
// 사용자가 공유를 확인한 후 실행 된 콜백 함수
},
취소 : function () {
// 사용자가 공유를 취소 한 후 실행 된 콜백 함수
}
});
이미지 인터페이스
사진을 찍거나 휴대폰 앨범 인터페이스에서 사진을 선택하십시오.
코드 사본은 다음과 같습니다.
wx.chooseimage ({
성공 : 기능 (RES) {
var localids = res.localids; // 선택한 사진의 로컬 ID 목록을 반환합니다. LocalID는 IMG 태그의 SRC 속성으로 사진을 표시 할 수 있습니다.
}
});
미리보기 사진 인터페이스
코드 사본은 다음과 같습니다.
wx.previewimage ({
현재 : '', // 현재 표시된 이미지에 대한 링크
URLS : [] // 미리보기가 필요한 이미지 링크 목록
});
이미지 인터페이스를 업로드합니다
코드 사본은 다음과 같습니다.
wx.uploadimage ({
localID : '', // choiceImage 인터페이스에서 얻은 이미지의 로컬 ID
ISSHOWProgressTips : 1 // 기본값은 1이며 진행 프롬프트를 표시합니다
성공 : 기능 (RES) {
var server = res.serverid; // 이미지의 서버 측 ID를 반환합니다
}
});
참고 : 멀티미디어 파일 인터페이스를 사용하여 WeChat으로 업로드 된 사진을 다운로드 할 수 있습니다. 여기에서 얻은 서버 디드는 Media_id입니다. 참조 문서 ../ 12/58BFCFABBD501C7CD77C19BD9CFA8354.HTML
그림 인터페이스를 다운로드하십시오
코드 사본은 다음과 같습니다.
wx.downloadImage ({
ServerId : '', // UPLOADIMAGE 인터페이스에서 얻은 이미지의 서버 측 ID
ISSHOWProgressTips : 1 // 기본값은 1이며 진행 프롬프트를 표시합니다
성공 : 기능 (RES) {
var localid = res.localid; // 이미지가 다운로드 된 후 로컬 ID를 반환합니다.
}
});
오디오 인터페이스
녹음 인터페이스를 시작하십시오
코드 사본은 다음과 같습니다.
wx.startrecord ();
인터페이스 기록을 중지하십시오
코드 사본은 다음과 같습니다.
wx.steprecord ({
성공 : 기능 (RES) {
var localid = res.localid;
}
});
기록 모니터링을위한 자동 정지 인터페이스
코드 사본은 다음과 같습니다.
wx.onvoicerecordend ({
// 녹음 시간이 1 분 이상이고 중지되지 않으면 완전한 콜백이 실행됩니다.
완료 : 함수 (res) {
var localid = res.localid;
}
});
음성 인터페이스를 재생하십시오
코드 사본은 다음과 같습니다.
wx.playvoice ({
LocalID : ''// 스톱 레코드 인터페이스에서 얻은 오디오의 로컬 ID
});
재생 인터페이스를 일시 중지합니다
코드 사본은 다음과 같습니다.
wx.pausevoice ({
localID : ''// 정지 레코드 인터페이스에서 얻은 일시 정지가 필요한 오디오의 로컬 ID
});
재생 인터페이스를 중지하십시오
코드 사본은 다음과 같습니다.
wx.stopvoice ({
localID : ''// 중지 해야하는 오디오의 로컬 ID, STOPRECORD 인터페이스에서 얻습니다.
});
음성 재생 인터페이스 모니터링
코드 사본은 다음과 같습니다.
wx.onvoiceplayend ({
serverid : '', // UPLOADVOICE 인터페이스에서 얻은 오디오의 서버 측 ID
성공 : 기능 (RES) {
var localid = res.localid; // 오디오의 로컬 ID를 반환합니다
}
});
음성 인터페이스를 업로드하십시오
코드 사본은 다음과 같습니다.
wx.uploadvoice ({
localID : '', // 정지 레코드 인터페이스에서 획득 해야하는 오디오의 로컬 ID
ISSHOWProgressTips : 1 // 기본값은 1이며 진행 프롬프트를 표시합니다
성공 : 기능 (RES) {
var server = res.serverid; // 오디오의 서버 측 ID를 반환합니다
}
});
참고 : WeChat의 멀티미디어 파일 인터페이스로 업로드 된 음성을 다운로드 할 수 있습니다. 여기에서 얻은 서버 디드는 Media_id입니다. 참조 문서 ../ 12/58BFCFABBD501C7CD77C19BD9CFA8354.HTML
음성 인터페이스를 다운로드하십시오
코드 사본은 다음과 같습니다.
wx.downloadvoice ({
serverid : '', // UPLOADVOICE 인터페이스에서 얻은 오디오의 서버 측 ID
ISSHOWProgressTips : 1 // 기본값은 1이며 진행 프롬프트를 표시합니다
성공 : 기능 (RES) {
var localid = res.localid; // 오디오의 로컬 ID를 반환합니다
}
});
지능형 인터페이스
오디오를 식별하고 인식 결과 인터페이스로 돌아갑니다
코드 사본은 다음과 같습니다.
wx.translatevoice ({{
LocalID : '', // 녹음 관련 인터페이스에서 얻은 오디오의 로컬 ID.
ISSHOWProgressTIPS : 1, // 기본값은 1이며 진행 프롬프트를 표시합니다
성공 : 기능 (RES) {
경고 (res.translateresult); // 음성 인식의 결과
}
});
장비 정보
네트워크 상태 인터페이스를 얻습니다
코드 사본은 다음과 같습니다.
wx.getnetworktype ({
성공 : 기능 (RES) {
var NetworkType = res.networkType; // 네트워크 유형을 반환합니다 2G, 3G, 4G, WiFi
}
});
지리적 위치
WeChat의 내장 맵을 사용하여 위치 인터페이스를보십시오.
코드 사본은 다음과 같습니다.
wx.openlocation ({
위도 : 0, // 위도, 부동 소수점 번호, 범위 90 ~ -90
경도 : 0, // 경도, 부동 소수점 번호는 180에서 -180입니다.
이름 : '', // 위치 이름
주소 : '', // 주소 세부 사항
스케일 : 1, // 맵 줌 레벨, 모양 값, 1에서 28의 범위. 기본값은 최대입니다.
Infourl : ''//보기 위치 인터페이스 하단에 표시된 하이퍼 링크를 클릭하여 점프 할 수 있습니다.
});
지리적 위치 인터페이스를 얻으십시오
코드 사본은 다음과 같습니다.
wx.getLocation ({
타임 스탬프 : 0, // 위치 서명 타임 스탬프, 버전 6.0.2 이전에만 제공됩니다.
Noncestr : '', // 위치 서명 임의 문자열, 버전 6.0.2 이전에만 사용할 수 있습니다.
addrsign : '', // 위치 서명, 버전 6.0.2 이전에만 제공되는 위치 서명, 자세한 내용은 부록 4를 참조하십시오.
성공 : 기능 (RES) {
var longitude = res.longitude; // 위도, 부동 소수점 번호, 범위 90 ~ -90
var latitude = res.latitude; // 경도, 부동 소수점 번호는 180에서 -180입니다.
var 속도 = res.speed; // 속도, 초당 미터로 측정됩니다
var 정확도 = res.accuracy; // 위치 정확도
}
});
인터페이스 작동
코드 사본은 다음과 같습니다.
오른쪽 상단의 메뉴 인터페이스를 숨 깁니다
wx.HideOptionMenu ();
오른쪽 상단에 메뉴 인터페이스를 표시합니다
wx.showoptionmenu ();
현재 웹 창 인터페이스를 닫습니다
wx.closewindow ();
배치 숨기기 기능 버튼 인터페이스
wx.hidemenuitems ({
Menulist : [] // 메뉴 항목을 숨기려면 부록 3 참조
});
배치 디스플레이 기능 버튼 인터페이스
wx.showmenuitems ({
Menulist : [] // 표시 할 모든 메뉴 항목이 부록 3에 표시됩니다.
});
비 바이시스 버튼 인터페이스를 숨기십시오
wx.hideallnonbasemenuitem ();
모든 기능 버튼 인터페이스를 표시합니다
wx.showallnonbasemenuitem ();
WeChat을 스캔하십시오
WeChat 스캔 인터페이스를 클릭하십시오
wx.scanqrcode ({
desc : 'scanqrcode desc',
NeedResult : 0, // 기본값은 0입니다. 스캔 결과는 WeChat에 의해 처리됩니다. 1 스캔 결과를 직접 반환합니다.
scantype : [ "qrcode", "barcode"], // QR 코드를 스캔할지 여부를 지정할 수 있습니다. 둘 다 기본값입니다.
성공 : function () {
var result = res.resultstr; // NeedResult가 1이면 코드를 스캔하여 결과를 반환합니다.
}
});
수확 주소
전달 주소 인터페이스 편집
코드 사본은 다음과 같습니다.
wx.editaddress (
타임 스탬프 : 0, // 위치 서명 타임 스탬프, 버전 6.0.2 이전에만 제공됩니다.
Noncestr : '', // 위치 서명 임의 문자열, 버전 6.0.2 이전에만 사용할 수 있습니다.
addrsign : '', // 위치 서명, 버전 6.0.2 이전에만 제공되는 위치 서명, 자세한 내용은 부록 4를 참조하십시오.
성공 : 기능 (RES) {
var username = res.username; // 수취인의 이름
var telnumber = res.telnumber; // Consignee의 전화 번호
var postalcode = res.postalcode; // 우편 번호
var provincename = res.provinceName; // 국가 표준 전달 주소 1 단계 주소
var cityName = res.cityName; // 국가 표준 전달 주소 주소 2 단계 주소
var countryname = res.countryName; // 국가 표준 전달 주소 3 단계 주소
var address = res.address; // 세부 전달 주소 정보
var nationalcode = res.nationalcode; // 전달 주소 국가 코드
}
});
가장 가까운 배송 주소 인터페이스를 얻으십시오
코드 사본은 다음과 같습니다.
wx.getLatestAddress ({{
타임 스탬프 : 0, // 위치 서명 타임 스탬프, 버전 6.0.2 이전에만 제공됩니다.
Noncestr : '', // 위치 서명 임의 문자열, 버전 6.0.2 이전에만 사용할 수 있습니다.
addrsign : '', // 위치 서명, 버전 6.0.2 이전에만 제공되는 위치 서명, 자세한 내용은 부록 4를 참조하십시오.
성공 : 기능 (RES) {
var username = res.username; // 수취인의 이름
var telnumber = res.telnumber; // Consignee의 전화 번호
var postalcode = res.postalcode; // 우편 번호
var provincename = res.provinceName; // 국가 표준 전달 주소 1 단계 주소
var cityName = res.cityName; // 국가 표준 전달 주소 주소 2 단계 주소
var countryname = res.countryName; // 국가 표준 전달 주소 3 단계 주소
var address = res.address; // 세부 전달 주소 정보
var nationalcode = res.nationalcode; // 전달 주소 국가 코드
}
});
Wechat 상점
WeChat 제품 페이지 인터페이스로 이동하십시오
코드 사본은 다음과 같습니다.
wx.openproductspecificview ({
productId : '', // 제품 ID
ViewType : ''// 0. 기본값, 일반 제품 세부 정보 페이지 1. 제품 세부 정보 스캔 페이지 2. 제품 세부 정보 저장 페이지 페이지
});
Wechat 카드 쿠폰
상점의 카드 쿠폰 목록을 릴리스하고 사용자 선택 목록을 얻으십시오.
코드 사본은 다음과 같습니다.
wx.choosecard ({
shopid : '', // 상점 ID
Cardtype : '', // 카드 유형
카디드 : '', // 카드 ID
타임 스탬프 : 0, // 카드 쿠폰 서명 타임 스탬프
Noncestr : '', // 임의의 카드 쿠폰 서명 문자열
Cardsign : '', // 카드 쿠폰 서명의 경우, 자세한 내용은 부록 6을 참조하십시오.
성공 : 기능 (RES) {
var cardlist = res.cardlist; // 사용자가 선택한 카드 목록 정보
}
});
배치로 카드 쿠폰 인터페이스를 추가하십시오
코드 사본은 다음과 같습니다.
wx.addcard ({
카드리스트 : [{
카디드 : '',
Cardext : ''
}], // 추가 할 카드 쿠폰 목록
성공 : 기능 (RES) {
var cardlist = res.cardlist; // 추가 카드 쿠폰 목록 정보
}
});
WeChat 카드 패키지에서 카드 쿠폰 인터페이스 확인
코드 사본은 다음과 같습니다.
wx.opencard ({
카드리스트 : [{
카디드 : '',
코드 : ''
}] // 열려야 할 카드 쿠폰 목록
});
wechat 지불
WeChat 지불 요청을 시작하십시오
코드 사본은 다음과 같습니다.
wx.choosewxpay ({
타임 스탬프 : 0, // 서명 타임 스탬프를 지불합니다
비정규 : '', // 결제 서명 랜덤 스트링
패키지 : '', // 주문 세부 사항은 부록 5를 참조하십시오.
PaySign : '', // 지불 서명, 자세한 내용은 부록 5를 참조하십시오.
});