wx.d.ts 128 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458345934603461346234633464346534663467346834693470347134723473347434753476347734783479348034813482348334843485348634873488348934903491349234933494349534963497349834993500350135023503350435053506350735083509351035113512351335143515351635173518351935203521352235233524352535263527352835293530353135323533353435353536353735383539354035413542354335443545354635473548354935503551355235533554355535563557355835593560356135623563356435653566356735683569357035713572357335743575357635773578357935803581358235833584358535863587358835893590359135923593359435953596359735983599360036013602360336043605360636073608360936103611361236133614361536163617361836193620362136223623362436253626362736283629363036313632363336343635363636373638363936403641364236433644364536463647364836493650365136523653365436553656365736583659366036613662366336643665366636673668366936703671367236733674367536763677367836793680368136823683368436853686368736883689369036913692369336943695369636973698369937003701370237033704370537063707370837093710371137123713371437153716371737183719372037213722372337243725372637273728372937303731373237333734373537363737373837393740374137423743374437453746374737483749375037513752375337543755375637573758375937603761376237633764376537663767376837693770377137723773377437753776377737783779378037813782378337843785378637873788378937903791379237933794379537963797379837993800380138023803380438053806380738083809381038113812381338143815381638173818381938203821382238233824382538263827382838293830383138323833383438353836383738383839384038413842384338443845384638473848384938503851385238533854385538563857385838593860386138623863386438653866386738683869387038713872387338743875387638773878387938803881388238833884388538863887388838893890389138923893389438953896389738983899390039013902390339043905390639073908390939103911391239133914391539163917391839193920392139223923392439253926392739283929393039313932393339343935393639373938393939403941394239433944394539463947394839493950395139523953395439553956395739583959396039613962396339643965396639673968396939703971397239733974397539763977397839793980398139823983398439853986398739883989399039913992399339943995399639973998399940004001400240034004400540064007400840094010401140124013401440154016401740184019402040214022402340244025402640274028402940304031403240334034403540364037403840394040404140424043404440454046404740484049405040514052405340544055405640574058405940604061406240634064406540664067406840694070407140724073407440754076407740784079408040814082408340844085408640874088408940904091
  1. // Type definitions for non-npm package wegame 2.7
  2. // Project: https://developers.weixin.qq.com/minigame/dev/index.html
  3. // Definitions by: J.C <https://github.com/jcyuan>
  4. // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
  5. // TypeScript Version: 3.0
  6. /**
  7. * IOS及安卓不支持:
  8. * globalCompositeOperation不支持以下值:source-in source-out destination-atop lighter copy
  9. * isPointInPath 不支持
  10. */
  11. declare class WxRenderingContext extends CanvasRenderingContext2D {
  12. }
  13. /**
  14. * IOS及安卓不支持:
  15. * pixelStorei 当第一个参数是 gl.UNPACK_COLORSPACE_CONVERSION_WEBGL 时不支持
  16. * compressedTexImage2D不支持
  17. * compressedTexSubImage2D不支持
  18. * 安卓不支持:
  19. * getExtension
  20. * getSupportedExtensions
  21. */
  22. declare class WxWebGLRenderingContext extends WebGLRenderingContext {
  23. /**
  24. * 将一个Canvas对应的Texture绑定到WebGL上下文。(目前该方法仅支持 iOS 6.6.6 以上版本,Android/开发者工具暂不支持。)
  25. * 示例:gl.wxBindCanvasTexture(gl.TEXTURE_2D, canvas)
  26. * @param texture WebGL的纹理类型枚举值
  27. * @param canvas 需要绑定为Texture的Canvas
  28. */
  29. wxBindCanvasTexture(texture: number, canvas: Canvas): void;
  30. }
  31. declare class WxPerformance {
  32. /**
  33. * 时间戳
  34. */
  35. now(): number;
  36. }
  37. declare class Canvas {
  38. /**
  39. * 画布的宽度
  40. */
  41. width: number;
  42. /**
  43. * 画布的高度
  44. */
  45. height: number;
  46. /**
  47. * 将当前 Canvas 保存为一个临时文件,并生成相应的临时文件路径。
  48. */
  49. toTempFilePath(p: wx.types.ToTempFileParams): void;
  50. /**
  51. * toTempFilePath 的同步版本
  52. */
  53. toTempFilePathSync(p: wx.types.ToTempFileSyncParams): string;
  54. /**
  55. * 获取画布对象的绘图上下文
  56. * @param contextType 上下文类型
  57. * @param contextAttributes webgl 上下文属性,仅当 contextType 为 webgl 时有效
  58. */
  59. getContext(contextType: "2d" | "webgl", contextAttributes?: wx.types.RenderingContextConfig): WxRenderingContext | WxWebGLRenderingContext;
  60. /**login
  61. * 把画布上的绘制内容以一个 data URI 的格式返回
  62. */
  63. toDataURL(): string;
  64. }
  65. declare namespace canvas {
  66. namespace types {
  67. interface CaxvasShareOption {
  68. /*
  69. * 截取 canvas 的左上角横坐标
  70. */
  71. x?: number;
  72. /*
  73. * 截取 canvas 的左上角纵坐标
  74. */
  75. y?: number;
  76. /*
  77. * 截取 canvas 的宽度
  78. */
  79. width?: number;
  80. /*
  81. * 截取 canvas 的高度
  82. */
  83. height?: number;
  84. /*
  85. * 目标文件的宽度,会将截取的部分拉伸或压缩至该数值
  86. */
  87. destWidth?: number;
  88. /*
  89. * 目标文件的高度,会将截取的部分拉伸或压缩至该数值
  90. */
  91. destHeight?: number;
  92. /*
  93. * 目标文件的类型
  94. */
  95. fileType?: string;
  96. /*
  97. * jpg图片的质量,仅当 fileType 为 jpg 时有效。
  98. * 取值范围为 0.0(最低)- 1.0(最高),不含 0。不在范围内时当作 1.0
  99. */
  100. quality?: number;
  101. /*
  102. * 接口调用成功的回调函数
  103. */
  104. success?: (res: successCallBack) => void;
  105. /*
  106. * 接口调用失败的回调函数
  107. */
  108. fail?: () => void;
  109. /*
  110. * 接口调用结束的回调函数(调用成功、失败都会执行)
  111. */
  112. complete?: () => void;
  113. }
  114. interface successCallBack {
  115. /*
  116. *错误信息
  117. */
  118. errMsg: string;
  119. /*
  120. * 图片地址
  121. */
  122. tempFilePath: string;
  123. }
  124. }
  125. function toTempFilePath(param: types.CaxvasShareOption): void;
  126. }
  127. declare class Stats {
  128. /**
  129. * 文件的类型和存取的权限,对应 POSIX stat.st_mode
  130. */
  131. mode: string;
  132. /**
  133. * 文件大小,单位:B,对应 POSIX stat.st_size
  134. */
  135. size: number;
  136. /**
  137. * 文件最近一次被存取或被执行的时间,UNIX 时间戳,对应 POSIX stat.st_atime
  138. */
  139. lastAccessedTime: number;
  140. /**
  141. * 文件最后一次被修改的时间,UNIX 时间戳,对应 POSIX stat.st_mtime
  142. */
  143. lastModifiedTime: number;
  144. /**
  145. * 判断当前文件是否一个目录
  146. */
  147. isDirectory(): boolean;
  148. /**
  149. * 判断当前文件是否一个普通文件
  150. */
  151. isFile(): boolean;
  152. }
  153. /**
  154. * 日志管理类,最多保存5M的日志内容,超过5M后,旧的日志内容会被删除。
  155. * 对于小程序,用户可以通过使用 button 组件的 open-type="feedback" 来上传打印的日志。
  156. * 对于小游戏,用户可以通过使用 wx.createFeedbackButton 来创建上传打印的日志的按钮。
  157. * 开发者可以通过小程序管理后台左侧菜单“反馈管理”页面查看相关打印日志。
  158. * 基础库默认会把 App、Page 的生命周期函数和 wx 命名空间下的函数调用写入日志。
  159. */
  160. declare class LogManager {
  161. /**
  162. * 写debug日志
  163. * @param args 要记录的日志内容
  164. */
  165. debug(...args: unknown[]): void;
  166. /**
  167. * 写info日志
  168. * @param args 要记录的日志内容
  169. */
  170. info(...args: unknown[]): void;
  171. /**
  172. * 写log日志
  173. * @param args 要记录的日志内容
  174. */
  175. log(...args: unknown[]): void;
  176. /**
  177. * 写warn日志
  178. * @param args 要记录的日志内容
  179. */
  180. warn(...args: unknown[]): void;
  181. }
  182. declare class FileSystemManager {
  183. /**
  184. * 重命名文件,可以把文件从 oldPath 移动到 newPath
  185. */
  186. rename(param: wx.types.RenameParams): void;
  187. /**
  188. * FileSystemManager.rename 的同步版本
  189. * @param oldPath 源文件路径,可以是普通文件或目录
  190. * @param newPath 新文件路径
  191. * @throws 指定源文件或目标文件没有写权限
  192. * @throws 源文件不存在,或目标文件路径的上层目录不存在
  193. */
  194. renameSync(oldPath: string, newPath: string): void;
  195. /**
  196. * 删除目录
  197. */
  198. rmdir(param: wx.types.RmdirParams): void;
  199. /**
  200. * rmdir 的同步版本
  201. * @param dirPath 要删除的目录路径
  202. * @param recursive 是否递归删除目录。如果为 true,则删除该目录和该目录下的所有子目录以及文件。
  203. * @throws 目录不存在, 目录不为空, 指定的 dirPath 路径没有写权限
  204. */
  205. rmdirSync(dirPath: string, recursive?: boolean): void;
  206. /**
  207. * 读取目录内文件列表
  208. */
  209. readdir(param: wx.types.ReaddirParams): void;
  210. /**
  211. * readdir的同步版本
  212. * @param dirPath 要读取的目录路径
  213. * @throws 目录不存在
  214. * @throws dirPath 不是目录
  215. * @throws 指定的 filePath 路径没有读权限
  216. */
  217. readdirSync(dirPath: string): ReadonlyArray<string>;
  218. /**
  219. * 创建目录
  220. */
  221. mkdir(param: wx.types.MkdirParams): void;
  222. /**
  223. * mkdir 的同步版本
  224. * @param dirPath 创建的目录路径
  225. * @param recursive 是否在递归创建该目录的上级目录后再创建该目录。如果对应的上级目录已经存在,则不创建该上级目录。如 dirPath 为 a/b/c/d 且 recursive 为 true,将创建 a 目录,再在 a 目录下创建 b 目录,以此类推直至创建 a/b/c 目录下的 d 目录。
  226. * @throws 上级目录不存在
  227. * @throws 指定的 filePath 路径没有写权限
  228. * @throws 有同名文件或目录
  229. */
  230. mkdirSync(dirPath: string, recursive?: boolean): void;
  231. /**
  232. * 解链文件
  233. */
  234. unlink(param: wx.types.UnlinkParams): void;
  235. /**
  236. * unlink 的同步版本
  237. * @param filePath 要解链的文件路径
  238. * @throws 指定的 path 路径没有读权限
  239. * @throws 文件不存在
  240. * @throws 传入的 filePath 是一个目录
  241. */
  242. unlinkSync(filePath: string): void;
  243. /**
  244. * 解压文件
  245. */
  246. unzip(param: wx.types.UnzipParams): void;
  247. /**
  248. * 读取本地文件内容
  249. */
  250. readFile(param: wx.types.ReadfileParams): void;
  251. /**
  252. * readFile 的同步版本,读取并返回指定路径的文件的原始二进制内容
  253. * @param filePath 要读取的文件的路径
  254. * @throws 指定的 filePath 所在目录不存在
  255. * @throws 指定的 filePath 路径没有读权限
  256. */
  257. readFileSync(filePath: string): ArrayBuffer;
  258. /**
  259. * readFile 的同步版本,读取并按指定字符编码返回字符串
  260. * @param filePath 要读取的文件的路径
  261. * @param encoding 指定读取文件的字符编码
  262. * @throws 指定的 filePath 所在目录不存在
  263. * @throws 指定的 filePath 路径没有读权限
  264. */
  265. readFileSync(filePath: string, encoding: wx.types.FileContentEncoding): string;
  266. /**
  267. * 获取文件 Stats 对象
  268. */
  269. stat(param: wx.types.StatParams): void;
  270. /**
  271. * stat 的同步版本
  272. * @param path 文件/目录路径
  273. * @throws 指定的 path 路径没有读权限
  274. * @throws 文件不存在
  275. */
  276. statSync(path: string): Stats;
  277. /**
  278. * 写文件
  279. */
  280. writeFile(param: wx.types.WritefileParams): void;
  281. /**
  282. * writeFile 的同步版本,写入二进制原始文件数据
  283. * @param filePath 要写入的文件路径
  284. * @param data 要写入的二进制数据
  285. * @throws 指定的 filePath 所在目录不存在
  286. * @throws 指定的 filePath 路径没有写权限
  287. */
  288. writeFileSync(filePath: string, data: ArrayBuffer): void;
  289. /**
  290. * writeFile 的同步版本,写入文本字符串数据至文件
  291. * @param filePath 要写入的文件路径
  292. * @param data 要写入的文本内容
  293. * @param encoding 指定写入的文本的字符编码格式
  294. * @throws 指定的 filePath 所在目录不存在
  295. * @throws 指定的 filePath 路径没有写权限
  296. */
  297. writeFileSync(filePath: string, data: string, encoding: wx.types.FileContentEncoding): void;
  298. /**
  299. * 判断文件/目录是否存在
  300. */
  301. access(param: wx.types.AccessfileParams): void;
  302. /**
  303. * access的同步版本
  304. * @param path 要判断是否存在的文件/目录路径
  305. * @throws 文件/目录不存在
  306. */
  307. accessSync(path: string): void;
  308. /**
  309. * 复制文件
  310. */
  311. copyFile(param: wx.types.CopyfileParams): void;
  312. /**
  313. * copyFile 的同步版本
  314. * @param srcPath 源文件路径,只可以是普通文件
  315. * @param destPath 目标文件路径
  316. * @throws 指定目标文件路径没有写权限
  317. * @throws 源文件不存在,或目标文件路径的上层目录不存在
  318. */
  319. copyFileSync(srcPath: string, destPath: string): void;
  320. /**
  321. * 获取该小程序下已保存的本地缓存文件列表
  322. * @param res.fileList.filePath 本地路径
  323. * @param res.fileList.size 本地文件大小,以字节为单位
  324. * @param res.fileList.createTime 文件创建时间
  325. */
  326. getSavedFileList(param: wx.types.CallbacksWithType<wx.types.SavedfileList>): void;
  327. /**
  328. * 获取该小程序下的 本地临时文件 或 本地缓存文件 信息
  329. */
  330. getFileInfo(param: wx.types.FileinfoParams): void;
  331. /**
  332. * 删除该小程序下已保存的本地缓存文件(新版本应使用unlink)
  333. */
  334. removeSavedFile(param: wx.types.RemovefileParams): void;
  335. /**
  336. * 保存临时文件到本地。此接口会移动临时文件,因此调用成功后,tempFilePath 将不可用。
  337. */
  338. saveFile(param: wx.types.SavefileParams): void;
  339. /**
  340. * saveFile的同步版本
  341. * @param tempFilePath 临时存储文件路径
  342. * @param filePath 要存储的文件路径
  343. * @throws 指定的 tempFilePath 找不到文件
  344. * @throws 指定的 filePath 路径没有写权限
  345. * @throws 上级目录不存在
  346. */
  347. saveFileSync(tempFilePath: string, filePath?: string): string;
  348. /**
  349. * 在文件结尾追加内容
  350. */
  351. appendFile(param: wx.types.AppendfileParams): void;
  352. /**
  353. * appendFile的同步版本
  354. * @param filePath 要追加内容的文件路径
  355. * @param data 要追加的文本或二进制数据
  356. * @param encoding 指定写入文件的字符编码
  357. * @throws 指定的 filePath 文件不存在
  358. * @throws 指定的 filePath 是一个已经存在的目录
  359. * @throws 指定的 filePath 路径没有写权限
  360. * @throws 指定的 filePath 是一个已经存在的目录
  361. */
  362. appendFileSync(filePath: string, data: string | ArrayBuffer, encoding: wx.types.FileContentEncoding): void;
  363. }
  364. declare class DownloadTask {
  365. /**
  366. * 中断下载任务
  367. */
  368. abort(): void;
  369. /**
  370. * 监听下载进度变化事件
  371. * @param res.progress 下载进度百分比,值为0至100
  372. * @param res.totalBytesWritten 已经下载的数据长度,单位 Bytes
  373. * @param res.totalBytesExpectedToWrite 预期需要下载的数据总长度,单位 Bytes
  374. */
  375. onProgressUpdate(callback: (res: { progress: number, totalBytesWritten: number, totalBytesExpectedToWrite: number }) => void): void;
  376. }
  377. declare class RequestTask {
  378. /**
  379. * 中断请求任务
  380. */
  381. abort(): void;
  382. }
  383. declare class SocketTask {
  384. /**
  385. * 通过WebSocket发送数据
  386. */
  387. send(param: wx.types.SocketSendParams): void;
  388. /**
  389. * 关闭WebSocket连接
  390. */
  391. close(param: wx.types.SocketCloseParams): void;
  392. /**
  393. * 监听WebSocket 连接打开事件
  394. */
  395. onOpen(callback: wx.types.SocketOpenCallback): void;
  396. /**
  397. * 监听WebSocket 连接关闭事件
  398. */
  399. onClose(callback: () => void): void;
  400. /**
  401. * 监听WebSocket 错误事件
  402. */
  403. onError(callback: wx.types.SocketErrorCallback): void;
  404. /**
  405. * 监听WebSocket 接受到服务器的消息事件
  406. */
  407. onMessage(callback: wx.types.SocketMessageCallback): void;
  408. }
  409. /**
  410. * 一个 UDP Socket 实例,默认使用 IPv4 协议。
  411. * 错误码:
  412. * -1 系统错误
  413. * -2 socket接口错误
  414. * -3 发送失败,无接口权限
  415. * 1 发送失败,参数错误,address不合法
  416. * 2 发送失败,参数错误,port不合法
  417. */
  418. declare class UDPSocket {
  419. /**
  420. * 绑定一个系统随机分配的可用端口,或绑定一个指定的端口号
  421. * @param port 需要绑定的端口号,不指定时使用随机端口
  422. * @returns 绑定成功的端口号
  423. */
  424. bind(port?: number): number;
  425. /**
  426. * 向指定的 IP 和 port 发送消息
  427. */
  428. send(param: wx.types.UDPSendParams): void;
  429. /**
  430. * 关闭 UDP Socket 实例,相当于销毁。 在关闭之后,UDP Socket 实例不能再发送消息,每次调用 UDPSocket.send 将会触发错误事件,
  431. * 并且 message 事件回调函数也不会再执行。在 UDPSocket 实例被创建后将被 Native 强引用,保证其不被 GC。在 UDPSocket.close 后
  432. * 将解除对其的强引用,让 UDPSocket 实例遵从 GC。
  433. */
  434. close(): void;
  435. /**
  436. * 设置监听关闭事件回调
  437. * @param callback 关闭事件的回调函数
  438. */
  439. onClose(callback: () => void): void;
  440. /**
  441. * 清除监听关闭事件回调
  442. * @param callback 之前监听的函数
  443. */
  444. offClose(callback: () => void): void;
  445. /**
  446. * 监听错误事件
  447. * @param callback 错误回调函数
  448. */
  449. onError(callback: (res: {
  450. /**
  451. * 错误信息
  452. */
  453. errMsg: string;
  454. }) => void): void;
  455. /**
  456. * 取消监听错误事件
  457. * @param callback 之前设置的错误回调函数
  458. */
  459. offError(callback: (res: {
  460. /**
  461. * 错误信息
  462. */
  463. errMsg: string;
  464. }) => void): void;
  465. /**
  466. * 监听开始监听数据包消息的事件
  467. * @param callback 回调函数
  468. */
  469. onListening(callback: () => void): void;
  470. /**
  471. * 取消监听开始监听数据包消息的事件
  472. * @param callback 之前设置的回调函数
  473. */
  474. offListening(callback: () => void): void;
  475. /**
  476. * 监听收到消息的事件
  477. * @param callback 回调函数
  478. */
  479. onMessage(callback: (res: wx.types.UDPMessage) => void): void;
  480. /**
  481. * 取消监听收到消息的事件
  482. * @param callback 之前设置的回调函数
  483. */
  484. offMessage(callback: (res: wx.types.UDPMessage) => void): void;
  485. }
  486. declare class UploadTask {
  487. /**
  488. * 中断上传任务
  489. */
  490. abort(): void;
  491. /**
  492. * 监听上传进度变化事件
  493. * @param callback.res.progress 上传进度百分比
  494. * @param callback.res.totalBytesSent 已经上传的数据长度,单位 Bytes
  495. * @param callback.res.totalBytesExpectedToSend 预期需要上传的数据总长度,单位 Bytes
  496. */
  497. onProgressUpdate(callback: (res: { progress: number, totalBytesSent: number, totalBytesExpectedToSend: number }) => void): void;
  498. }
  499. declare class KVData {
  500. key: string;
  501. value: string;
  502. }
  503. declare class UserGameData {
  504. /**
  505. * 用户的微信头像 url
  506. */
  507. avatarUrl: string;
  508. /**
  509. * 用户的微信昵称
  510. */
  511. nickname: string;
  512. /**
  513. * 用户的openid
  514. */
  515. openid: string;
  516. /**
  517. * 用户的托管 KV 数据列表
  518. */
  519. KVDataList: ReadonlyArray<KVData>;
  520. }
  521. declare class CreatedButton {
  522. type: wx.types.ButtonType;
  523. text: string;
  524. image: string;
  525. style: wx.types.ButtonStyle;
  526. show(): void;
  527. hide(): void;
  528. onTap(callback: (res?: any) => void): void; // res参数会被具体按钮的API定义覆盖为具体信息
  529. offTap(callback: (res?: any) => void): void;
  530. destroy(): void;
  531. }
  532. declare class UserInfoButton extends CreatedButton {
  533. onTap(callback: (res: {
  534. /**
  535. * 用户信息对象,不包含 openid 等敏感信息
  536. */
  537. userInfo: wx.types.UserInfo,
  538. /**
  539. * 不包括敏感信息的原始数据字符串,用于计算签名
  540. */
  541. rawData: string,
  542. /**
  543. * 使用 sha1( rawData + sessionkey ) 得到字符串,用于校验用户信息,参考文档signature(https://mp.weixin.qq.com/debug/wxagame/dev/tutorial/open-ability/http-signature.html?t=201822)
  544. */
  545. signature: string,
  546. /**
  547. * 包括敏感数据在内的完整用户信息的加密数据,详见加密数据解密算法(https://mp.weixin.qq.com/debug/wxagame/dev/tutorial/open-ability/signature.html?t=201822)
  548. */
  549. encryptedData: string,
  550. /**
  551. * 加密算法的初始向量,详见加密数据解密算法(https://mp.weixin.qq.com/debug/wxagame/dev/tutorial/open-ability/signature.html?t=201822)
  552. */
  553. iv: string,
  554. errMsg: string
  555. }) => void): void;
  556. }
  557. declare class OpenSettingButton extends CreatedButton {
  558. onTap(callback: () => void): void;
  559. offTap(callback: () => void): void;
  560. }
  561. declare class GameClubButton extends CreatedButton {
  562. icon: wx.types.GameClubButtonIcon;
  563. onTap(callback: (res: {
  564. errMsg: string;
  565. }) => void): void;
  566. }
  567. declare class FeedbackButton extends CreatedButton {
  568. onTap(callback: (res: {
  569. errMsg: string;
  570. }) => void): void;
  571. }
  572. declare class OpenDataContext {
  573. /**
  574. * 开放数据域和主域共享的 sharedCanvas,注意在开放数据域内时getContext只能使用2d模式
  575. */
  576. canvas: Canvas;
  577. /**
  578. * 向开放数据域发送消息
  579. * @param message 要发送的消息,message 中及嵌套对象中 key 的 value 只能是 primitive value。即 number、string、boolean、null、undefined。
  580. */
  581. postMessage(message: any): void;
  582. }
  583. declare class LoadSubpackageTask {
  584. /**
  585. * 监听分包加载进度变化事件
  586. * @param callback.res.progress 分包下载进度百分比
  587. * @param callback.res.totalBytesWritten 已经下载的数据长度,单位 Bytes
  588. * @param callback.res.totalBytesExpectedToWrite 预期需要下载的数据总长度,单位 Bytes
  589. */
  590. onProgressUpdate(callback: (res: { progress: number, totalBytesWritten: number, totalBytesExpectedToWrite: number }) => void): void;
  591. }
  592. declare class UpdateManager {
  593. /**
  594. * 应用更新包并重启
  595. */
  596. applyUpdate(): void;
  597. /**
  598. * 监听检查更新结果回调
  599. */
  600. onCheckForUpdate(callback: (res) => void): void;
  601. /**
  602. * 监听更新包下载成功回调
  603. */
  604. onUpdateReady(callback: () => void): void;
  605. /**
  606. * 监听更新包下载失败回调
  607. */
  608. onUpdateFailed(callback: () => void): void;
  609. }
  610. declare class WxWorker {
  611. /**
  612. * 向主线程或Worker线程发送的消息。
  613. * @param message 需要发送的消息,必须是一个可序列化的 JavaScript 对象。
  614. */
  615. postMessage(message: any): void;
  616. /**
  617. * 结束当前 worker 线程,仅限在主线程 worker 对象上调用。
  618. */
  619. terminate(): void;
  620. /**
  621. * 监听接收主线程/Worker 线程向当前线程发送的消息
  622. * @param callback.res.message 接收主线程/Worker 线程向当前线程发送的消息
  623. */
  624. onMessage(callback: (res: { message: any }) => void): void;
  625. }
  626. /**
  627. * InnerAudioContext 实例,可通过 wx.createInnerAudioContext 接口获取实例。
  628. */
  629. declare class InnerAudioContext {
  630. /**
  631. * 音频资源的地址
  632. */
  633. src: string;
  634. /**
  635. * 是否自动播放
  636. */
  637. autoplay: boolean;
  638. /**
  639. * 是否循环播放
  640. */
  641. loop: boolean;
  642. /**
  643. * 是否遵循系统静音开关,当此参数为 false 时,即使用户打开了静音开关,也能继续发出声音
  644. */
  645. obeyMuteSwitch: boolean;
  646. /**
  647. * 当前音频的长度,单位 s。只有在当前有合法的 src 时返回
  648. */
  649. readonly duration: number;
  650. /**
  651. * 当前音频的播放位置,单位 s。只有在当前有合法的 src 时返回,时间不取整,保留小数点后 6 位
  652. */
  653. readonly currentTime: number;
  654. /**
  655. * 当前是是否暂停或停止状态,true 表示暂停或停止,false 表示正在播放
  656. */
  657. paused: boolean;
  658. /**
  659. * 音频缓冲的时间点,仅保证当前播放时间点到此时间点内容已缓冲
  660. */
  661. readonly buffered: number;
  662. /**
  663. * 音量。范围 0~1。
  664. */
  665. volume: number;
  666. /**
  667. * 播放
  668. */
  669. play(): void;
  670. /**
  671. * 暂停。暂停后的音频再播放会从暂停处开始播放
  672. */
  673. pause(): void;
  674. /**
  675. * 停止。停止后的音频再播放会从头开始播放。
  676. */
  677. stop(): void;
  678. /**
  679. * 跳转到指定位置,单位 s
  680. * @param position 跳转的时间
  681. */
  682. seek(position: number): void;
  683. /**
  684. * 销毁当前实例
  685. */
  686. destroy(): void;
  687. /**
  688. * 监听音频进入可以播放状态的事件
  689. */
  690. onCanplay(callback: () => void): void;
  691. /**
  692. * 取消监听音频进入可以播放状态的事件
  693. */
  694. offCanplay(callback: () => void): void;
  695. /**
  696. * 监听音频播放事件
  697. */
  698. onPlay(callback: () => void): void;
  699. /**
  700. * 取消监听音频播放事件
  701. */
  702. offPlay(callback: () => void): void;
  703. /**
  704. * 监听音频暂停事件
  705. */
  706. onPause(callback: () => void): void;
  707. /**
  708. * 取消监听音频暂停事件
  709. */
  710. offPause(callback: () => void): void;
  711. /**
  712. * 监听音频停止事件
  713. */
  714. onStop(callback: () => void): void;
  715. /**
  716. * 取消监听音频停止事件
  717. */
  718. offStop(callback: () => void): void;
  719. /**
  720. * 监听音频自然播放至结束的事件
  721. */
  722. onEnded(callback: () => void): void;
  723. /**
  724. * 取消监听音频自然播放至结束的事件
  725. */
  726. offEnded(callback: () => void): void;
  727. /**
  728. * 监听音频播放进度更新事件
  729. */
  730. onTimeUpdate(callback: () => void): void;
  731. /**
  732. * 取消监听音频播放进度更新事件
  733. */
  734. offTimeUpdate(callback: () => void): void;
  735. /**
  736. * 监听音频播放错误事件
  737. */
  738. onError(callback: () => void): void;
  739. /**
  740. * 取消监听音频播放错误事件
  741. */
  742. offError(callback: () => void): void;
  743. /**
  744. * 监听音频加载中事件,当音频因为数据不足,需要停下来加载时会触发
  745. */
  746. onWaiting(callback: () => void): void;
  747. /**
  748. * 取消监听音频加载中事件,当音频因为数据不足,需要停下来加载时会触发
  749. */
  750. offWaiting(callback: () => void): void;
  751. /**
  752. * 监听音频进行跳转操作的事件
  753. */
  754. onSeeking(callback: () => void): void;
  755. /**
  756. * 取消监听音频进行跳转操作的事件
  757. */
  758. offSeeking(callback: () => void): void;
  759. /**
  760. * 监听音频完成跳转操作的事件
  761. */
  762. onSeeked(callback: () => void): void;
  763. /**
  764. * 取消监听音频完成跳转操作的事件
  765. */
  766. offSeeked(callback: () => void): void;
  767. }
  768. declare class RecorderManager {
  769. /**
  770. * 开始录音
  771. */
  772. start(param: {
  773. /**
  774. * 录音的时长,单位 ms,最大值 600000(10 分钟),默认值60000(1 分钟)
  775. */
  776. duration?: number,
  777. /**
  778. * 采样率
  779. */
  780. sampleRate: 8000 | 11025 | 12000 | 16000 | 22050 | 24000 | 32000 | 44100 | 48000,
  781. /**
  782. * 录音通道数
  783. */
  784. numberOfChannels: 1 | 2,
  785. /**
  786. * 编码码率
  787. */
  788. encodeBitRate: number,
  789. /**
  790. * 音频格式
  791. */
  792. format: "mp3" | "aac",
  793. /**
  794. * 指定帧大小,单位 KB。传入 frameSize 后,每录制指定帧大小的内容后,会回调录制的文件内容,不指定则不会回调
  795. */
  796. frameSize: number,
  797. /**
  798. * 指定录音的音频源,可通过 wx.getAvailableAudioSources() 获取当前可用的音频源,默认值auto
  799. */
  800. audioSource?: wx.types.AudioSourceType
  801. }): void;
  802. /**
  803. * 暂停录音
  804. */
  805. pause(): void;
  806. /**
  807. * 继续录音
  808. */
  809. resume(): void;
  810. /**
  811. * 停止录音
  812. */
  813. stop(): void;
  814. /**
  815. * 监听录音开始事件
  816. */
  817. onStart(callback: () => void): void;
  818. /**
  819. * 监听录音继续事件
  820. */
  821. onResume(callback: () => void): void;
  822. /**
  823. * 监听录音暂停事件
  824. */
  825. onPause(callback: () => void): void;
  826. /**
  827. * 监听录音结束事件
  828. * @param callback.res.tempFilePath 录音文件的临时路径
  829. */
  830. onStop(callback: (res: { tempFilePath: string }) => void): void;
  831. /**
  832. * 监听已录制完指定帧大小的文件事件。如果设置了 frameSize,则会回调此事件。
  833. * @param callback.res.frameBuffer 录音分片数据
  834. * @param callback.res.isLastFrame 当前帧是否正常录音结束前的最后一帧
  835. */
  836. onFrameRecorded(callback: (res: { frameBuffer: ArrayBuffer, isLastFrame: boolean }) => void): void;
  837. /**
  838. * 监听录音错误事件
  839. */
  840. onError(callback: (res: { errMsg: string }) => void): void;
  841. }
  842. declare class ImageFile {
  843. /**
  844. * 本地文件路径
  845. */
  846. path: string;
  847. /**
  848. * 本地文件大小,单位 B
  849. */
  850. size: number;
  851. }
  852. declare class Video {
  853. /**
  854. * 视频的左上角横坐标
  855. */
  856. x: number;
  857. /**
  858. * 视频的左上角纵坐标
  859. */
  860. y: number;
  861. /**
  862. * 视频的宽度,默认值300
  863. */
  864. width: number;
  865. /**
  866. * 默认值150
  867. */
  868. height: number;
  869. /**
  870. * 视频的资源地址
  871. */
  872. src: string;
  873. /**
  874. * 视频的封面
  875. */
  876. poster: string;
  877. /**
  878. * 视频的初始播放位置,单位为 s 秒,默认值0
  879. */
  880. initialTime: number;
  881. /**
  882. * 视频的播放速率,有效值有 0.5、0.8、1.0、1.25、1.5默认值1.0
  883. */
  884. playbackRate: number;
  885. /**
  886. * 视频是否为直播,默认值0
  887. */
  888. live?: number;
  889. /**
  890. * 视频的缩放模式
  891. * fill - 填充,视频拉伸填满整个容器,不保证保持原有长宽比例
  892. * contain - 包含,保持原有长宽比例。保证视频尺寸一定可以在容器里面放得下。因此,可能会有部分空白
  893. * cover - 覆盖,保持原有长宽比例。保证视频尺寸一定大于容器尺寸,宽度和高度至少有一个和容器一致。因此,视频有部分会看不见
  894. */
  895. objectFit: "contain" | "cover" | "fill";
  896. /**
  897. * 视频是否显示控件,默认true
  898. */
  899. controls: boolean;
  900. /**
  901. * 视频是否自动播放,默认false
  902. */
  903. autoplay: boolean;
  904. /**
  905. * 视频是否是否循环播放,默认值false
  906. */
  907. loop: boolean;
  908. /**
  909. * 视频是否禁音播放,默认值false
  910. */
  911. muted: boolean;
  912. /**
  913. * 视频开始缓冲时触发的回调函数
  914. */
  915. onwaiting: () => void;
  916. /**
  917. * 视频开始播放时触发的回调函数
  918. */
  919. onplay: () => void;
  920. /**
  921. * 视频暂停时触发的回调函数
  922. */
  923. onpause: () => void;
  924. /**
  925. * 视频播放到末尾时触发的回调函数
  926. */
  927. onended: () => void;
  928. /**
  929. * 每当视频播放进度更新时触发的回调函数
  930. */
  931. ontimeupdate: () => void;
  932. /**
  933. * 视频发生错误时触发的回调函数
  934. */
  935. onerror: () => void;
  936. /**
  937. * 销毁视频
  938. */
  939. destroy(): void;
  940. /**
  941. * 监听视频缓冲事件
  942. */
  943. onWaiting(callback: () => void): void;
  944. /**
  945. * 取消监听视频缓冲事件
  946. */
  947. offWaiting(callback: () => void): void;
  948. /**
  949. * 监听视频播放事件
  950. */
  951. onPlay(callback: () => void): void;
  952. /**
  953. * 取消监听视频播放事件
  954. */
  955. offPlay(callback: () => void): void;
  956. /**
  957. * 监听视频暂停事件
  958. */
  959. onPause(callback: () => void): void;
  960. /**
  961. * 取消监听视频暂停事件
  962. */
  963. offPause(callback: () => void): void;
  964. /**
  965. * 监听视频播放到末尾事件
  966. */
  967. onEnded(callback: () => void): void;
  968. /**
  969. * 取消监听视频播放到末尾事件
  970. */
  971. offEnded(callback: () => void): void;
  972. /**
  973. * 监听视频播放进度更新事件
  974. * @param callback.res.position 当前的播放位置,单位为秒
  975. * @param callback.res.duration 视频的总时长,单位为秒
  976. */
  977. onTimeUpdate(callback: (res: { position: number, duration: number }) => void): void;
  978. /**
  979. * 取消监听视频播放进度更新事件
  980. */
  981. offTimeUpdate(callback: (res: { position: number, duration: number }) => void): void;
  982. /**
  983. * 监听视频错误事件
  984. * @param callback.res.errMsg 错误信息,有如下值
  985. * MEDIA_ERR_NETWORK - 当下载时发生错误
  986. * MEDIA_ERR_DECODE - 当解码时发生错误
  987. * MEDIA_ERR_SRC_NOT_SUPPORTED - video 的 src 属性是不支持的资源类型
  988. */
  989. onError(callback: (res: { errMsg: string }) => void): void;
  990. /**
  991. * 取消监听视频错误事件
  992. */
  993. offError(callback: (res: { errMsg: string }) => void): void;
  994. /**
  995. * 播放视频
  996. */
  997. play(): Promise<void>;
  998. /**
  999. * 暂停视频
  1000. */
  1001. pause(): Promise<void>;
  1002. /**
  1003. * 停止视频
  1004. */
  1005. stop(): Promise<void>;
  1006. /**
  1007. * 视频跳转
  1008. * @param time 视频跳转到指定位置,单位为 s 秒
  1009. */
  1010. seek(time: number): Promise<void>;
  1011. /**
  1012. * 视频全屏
  1013. */
  1014. requestFullScreen(): Promise<void>;
  1015. /**
  1016. * 视频退出全屏
  1017. */
  1018. exitFullScreen(): Promise<void>;
  1019. }
  1020. /**
  1021. * 相机对象
  1022. */
  1023. declare class Camera {
  1024. /**
  1025. * 相机的左上角横坐标
  1026. */
  1027. x: number;
  1028. /**
  1029. * 相机的左上角纵坐标
  1030. */
  1031. y: number;
  1032. /**
  1033. * 相机的宽度
  1034. */
  1035. width: number;
  1036. /**
  1037. * 相机的高度
  1038. */
  1039. height: number;
  1040. /**
  1041. * 摄像头朝向
  1042. */
  1043. devicePosition: "front" | "back";
  1044. /**
  1045. * 闪光灯状态
  1046. */
  1047. flash: "auto" | "on" | "off";
  1048. /**
  1049. * 帧数据图像尺寸
  1050. */
  1051. size: "small" | "medium" | "large";
  1052. /**
  1053. * 拍照,可指定质量,成功则返回图片
  1054. * @param quality 图片质量
  1055. */
  1056. takePhoto(quality?: "high" | "normal" | "low"): Promise<{
  1057. /**
  1058. * 临时图片路径
  1059. */
  1060. tempImagePath: string,
  1061. /**
  1062. * 图片宽度
  1063. */
  1064. width: string,
  1065. /**
  1066. * 图片高度
  1067. */
  1068. height: string
  1069. }>;
  1070. /**
  1071. * 开始录像
  1072. */
  1073. startRecord(): Promise<void>;
  1074. /**
  1075. * 结束录像,成功则返回封面与视频
  1076. * @param compressed 是否压缩录制视频
  1077. */
  1078. stopRecord(compressed: boolean): Promise<{
  1079. /**
  1080. * 临时视频路径
  1081. */
  1082. tempThumbPath: string,
  1083. /**
  1084. * 临时封面路径
  1085. */
  1086. tempVideoPath: string
  1087. }>;
  1088. /**
  1089. * 监听用户不允许授权使用摄像头的情况
  1090. * @param callback 回调函数
  1091. */
  1092. onAuthCancel(callback: () => void): void;
  1093. /**
  1094. * 监听摄像头非正常终止事件,如退出后台等情况
  1095. * @param callback 回调函数
  1096. */
  1097. onStop(callback: () => void): void;
  1098. /**
  1099. * 监听摄像头实时帧数据
  1100. */
  1101. onCameraFrame(callback: (res: {
  1102. /**
  1103. * 图像数据矩形的宽度
  1104. */
  1105. width: number,
  1106. /**
  1107. * 图像数据矩形的高度
  1108. */
  1109. height: number,
  1110. /**
  1111. * 图像像素点数据,一维数组,每四项表示一个像素点的 rgba
  1112. */
  1113. data: ArrayBuffer
  1114. }) => void): void;
  1115. /**
  1116. * 开启监听帧数据
  1117. */
  1118. listenFrameChange(): void;
  1119. /**
  1120. * 关闭监听帧数据
  1121. */
  1122. closeFrameChange(): void;
  1123. /**
  1124. * 销毁相机
  1125. */
  1126. destroy(): void;
  1127. }
  1128. /**
  1129. * banner 广告组件。banner 广告组件是一个原生组件,层级比上屏 Canvas 高,会覆盖在上屏 Canvas 上。banner 广告组件默认是隐藏的,需要调用 BannerAd.show() 将其显示。banner 广告会根据开发者设置的宽度进行等比缩放,缩放后的尺寸将通过 BannerAd.onResize() 事件中提供。
  1130. */
  1131. declare class BannerAd {
  1132. /**
  1133. * 广告单元 id
  1134. */
  1135. adUnitId: string;
  1136. /**
  1137. * banner 广告组件的样式。style 上的属性的值仅为开发者设置的值,banner 广告会根据开发者设置的宽度进行等比缩放,缩放后的真实尺寸需要通过 BannerAd.onResize() 事件获得。
  1138. */
  1139. style: wx.types.AdStyle;
  1140. /**
  1141. * 显示 banner 广告。
  1142. */
  1143. show(): Promise<void>;
  1144. /**
  1145. * 隐藏 banner 广告
  1146. */
  1147. hide(): void;
  1148. /**
  1149. * 销毁 banner 广告
  1150. */
  1151. destroy(): void;
  1152. /**
  1153. * 监听 banner 广告缩放
  1154. */
  1155. onResize(callback: (res: { width: number, height: number }) => void): void;
  1156. /**
  1157. * 取消监听隐藏 banner 广告缩放
  1158. */
  1159. offResize(callback: (res: { width: number, height: number }) => void): void;
  1160. /**
  1161. * 监听banner 广告加载事件
  1162. */
  1163. onLoad(callback: () => void): void;
  1164. /**
  1165. * 取消监听banner 广告加载事件
  1166. */
  1167. offLoad(callback: () => void): void;
  1168. /**
  1169. * 监听banner 广告错误事件
  1170. */
  1171. onError(callback: (res: { errMsg: string }) => void): void;
  1172. /**
  1173. * 取消监听banner 广告错误事件
  1174. */
  1175. offError(callback: (res: { errMsg: string }) => void): void;
  1176. }
  1177. declare class InterstitialAd extends BannerAd {
  1178. /**
  1179. * 加载视频广告
  1180. */
  1181. load(): Promise<void>;
  1182. /**
  1183. * 监听用户点击 关闭广告 按钮的事件
  1184. */
  1185. onClose(callback: (res: { isEnded: boolean }) => void): void;
  1186. /**
  1187. * 监听用户点击 关闭广告 按钮的事件
  1188. */
  1189. offClose(callback: (res: { isEnded: boolean }) => void): void;
  1190. }
  1191. declare class RewardedVideoAd extends InterstitialAd {
  1192. }
  1193. // --定时器
  1194. declare function clearTimeout(timeoutID: number): void;
  1195. declare function clearInterval(intervalID: number): void;
  1196. declare function setTimeout(fn: () => void, delay: number, ...rest: any[]): number;
  1197. declare function setInterval(fn: () => void, delay: number, ...rest: any[]): number;
  1198. // --渲染
  1199. declare function cancelAnimationFrame(requestID: number): void;
  1200. declare function requestAnimationFrame(callback: () => void): number;
  1201. declare namespace wx {
  1202. namespace types {
  1203. interface Callbacks {
  1204. success?: () => void;
  1205. fail?: () => void;
  1206. complete?: () => void;
  1207. }
  1208. interface CallbacksWithType<T> {
  1209. success?: (res: T) => void;
  1210. fail?: () => void;
  1211. complete?: () => void;
  1212. }
  1213. interface CallbacksWithType2<T, F> {
  1214. success?: (res: T) => void;
  1215. fail?: (res: F) => void;
  1216. complete?: () => void;
  1217. }
  1218. interface RenderingContextConfig {
  1219. /**
  1220. * 表示是否抗锯齿
  1221. */
  1222. antialias?: boolean;
  1223. /**
  1224. * 表示是否绘图完成后是否保留绘图缓冲区
  1225. */
  1226. preserveDrawingBuffer?: boolean;
  1227. /**
  1228. * 抗锯齿样本数。最小值为 2,最大不超过系统限制数量,仅 iOS 支持
  1229. */
  1230. antialiasSamples?: number;
  1231. }
  1232. interface ToTempFileSyncParams {
  1233. /**
  1234. * 截取 canvas 的左上角横坐标
  1235. */
  1236. x?: number;
  1237. /**
  1238. * 截取 canvas 的左上角纵坐标
  1239. */
  1240. y?: number;
  1241. /**
  1242. * 截取 canvas 的宽度
  1243. */
  1244. width?: number;
  1245. /**
  1246. * 截取 canvas 的高度
  1247. */
  1248. height?: number;
  1249. /**
  1250. * 目标文件的宽度,会将截取的部分拉伸或压缩至该数值
  1251. */
  1252. destWidth?: number;
  1253. /**
  1254. * 目标文件的高度,会将截取的部分拉伸或压缩至该数值
  1255. */
  1256. destHeight?: number;
  1257. /**
  1258. * 目标文件的类型
  1259. */
  1260. fileType?: "jpg" | "png";
  1261. /**
  1262. * jpg图片的质量,仅当 fileType 为 jpg 时有效。取值范围为 0.0(最低)- 1.0(最高),不含 0。不在范围内时当作 1.0
  1263. */
  1264. quality?: number;
  1265. }
  1266. interface ToTempFileParams extends ToTempFileSyncParams {
  1267. success?: (res: { tempFilePath: string }) => void;
  1268. fail?: () => void;
  1269. complete?: () => void;
  1270. }
  1271. interface RenameParams {
  1272. oldPath: string;
  1273. newPath: string;
  1274. success?: () => void;
  1275. fail?: (res: { errMsg: string }) => void;
  1276. complete?: () => void;
  1277. }
  1278. interface RmdirParams {
  1279. dirPath: string;
  1280. recursive?: boolean;
  1281. success?: () => void;
  1282. fail?: (res: { errMsg: string }) => void;
  1283. complete?: () => void;
  1284. }
  1285. interface ReaddirParams {
  1286. dirPath: string;
  1287. success?: (res: { files: ReadonlyArray<string> }) => void;
  1288. fail?: (res: { errMsg: string }) => void;
  1289. complete?: () => void;
  1290. }
  1291. interface MkdirParams {
  1292. dirPath: string;
  1293. recursive?: boolean;
  1294. success?: () => void;
  1295. fail?: (res: { errMsg: string }) => void;
  1296. complete?: () => void;
  1297. }
  1298. type FileContentEncoding = "ascii" | "base64" | "binary" | "hex" | "ucs2" | "ucs-2" | "utf16le" | "utf-16le" | "utf-8" | "utf8" | "latin1";
  1299. interface ReadfileParams {
  1300. filePath: string;
  1301. encoding?: FileContentEncoding;
  1302. success?: (res: { data: string | ArrayBuffer }) => void;
  1303. fail?: (res: { errMsg: string }) => void;
  1304. complete?: () => void;
  1305. }
  1306. interface StatParams {
  1307. path: string;
  1308. success?: (res: { stat: Stats }) => void;
  1309. fail?: (res: { errMsg: string }) => void;
  1310. complete?: () => void;
  1311. }
  1312. interface WritefileParams {
  1313. filePath: string;
  1314. data: string | ArrayBuffer;
  1315. encoding?: FileContentEncoding;
  1316. success?: () => void;
  1317. fail?: (res: { errMsg: string }) => void;
  1318. complete?: () => void;
  1319. }
  1320. interface UnlinkParams {
  1321. filePath: string;
  1322. success?: () => void;
  1323. fail?: (res: { errMsg: string }) => void;
  1324. complete?: () => void;
  1325. }
  1326. interface UnzipParams {
  1327. zipFilePath: string;
  1328. targetPath: string;
  1329. success?: () => void;
  1330. fail?: (res: { errMsg: string }) => void;
  1331. complete?: () => void;
  1332. }
  1333. interface AccessfileParams {
  1334. path: string;
  1335. success?: () => void;
  1336. fail?: (res: { errMsg: string }) => void;
  1337. complete?: () => void;
  1338. }
  1339. interface SavedfileList {
  1340. fileList: {
  1341. filePath: string;
  1342. size: number;
  1343. createTime: number;
  1344. };
  1345. }
  1346. interface CopyfileParams {
  1347. srcPath: string;
  1348. destPath: string;
  1349. success?: () => void;
  1350. fail?: (res: { errMsg: string }) => void;
  1351. complete?: () => void;
  1352. }
  1353. interface FileinfoParams {
  1354. filePath: string;
  1355. success?: (res: { size: number, digest: string }) => void;
  1356. fail?: (res: { errMsg: string }) => void;
  1357. complete?: () => void;
  1358. }
  1359. interface RemovefileParams {
  1360. filePath: string;
  1361. success?: () => void;
  1362. fail?: () => void;
  1363. complete?: () => void;
  1364. }
  1365. interface SavefileParams {
  1366. tempFilePath: string;
  1367. filePath?: string;
  1368. success?: (res: { savedFilePath: string }) => void;
  1369. fail?: (res: { errMsg: string }) => void;
  1370. complete?: () => void;
  1371. }
  1372. interface AppendfileParams {
  1373. filePath: string;
  1374. data: string | ArrayBuffer;
  1375. encoding?: FileContentEncoding;
  1376. success?: () => void;
  1377. fail?: (res: { errMsg: string }) => void;
  1378. complete?: () => void;
  1379. }
  1380. interface LineHeightParams {
  1381. fontStyle?: "normal" | "italic";
  1382. fontWeight?: "normal" | "bold";
  1383. fontSize?: number;
  1384. fontFamily: string;
  1385. text: string;
  1386. success?: (res: { lineHeight: number }) => void;
  1387. fail?: () => void;
  1388. complete?: () => void;
  1389. }
  1390. interface Image {
  1391. src: string;
  1392. width: number;
  1393. height: number;
  1394. onload: () => void;
  1395. onerror: (e?: any) => void;
  1396. }
  1397. // --启动参数
  1398. interface LaunchOption {
  1399. /**
  1400. * 场景值
  1401. */
  1402. scene: number;
  1403. /**
  1404. * 启动参数
  1405. */
  1406. query: any;
  1407. /**
  1408. * 当前小游戏是否被显示在聊天顶部
  1409. */
  1410. isSticky: boolean;
  1411. /**
  1412. * 票据
  1413. */
  1414. shareTicket: string;
  1415. }
  1416. // --系统信息
  1417. interface SystemInfo {
  1418. /**
  1419. * 手机品牌
  1420. */
  1421. brand: string;
  1422. /**
  1423. * 手机型号
  1424. */
  1425. model: string;
  1426. /**
  1427. * 设备像素比
  1428. */
  1429. pixelRatio: number;
  1430. /**
  1431. * 屏幕宽度
  1432. */
  1433. screenWidth: number;
  1434. /**
  1435. * 屏幕高度
  1436. */
  1437. screenHeight: number;
  1438. /**
  1439. * 可使用窗口宽度
  1440. */
  1441. windowWidth: number;
  1442. /**
  1443. * 可使用窗口高度
  1444. */
  1445. windowHeight: number;
  1446. /**
  1447. * 微信设置的语言
  1448. */
  1449. language: string;
  1450. /**
  1451. * 微信版本号
  1452. */
  1453. version: string;
  1454. /**
  1455. * 操作系统版本
  1456. */
  1457. system: string;
  1458. /**
  1459. * 客户端平台
  1460. */
  1461. platform: string;
  1462. /**
  1463. * 用户字体大小设置。以“我-设置-通用-字体大小”中的设置为准,单位 px。
  1464. */
  1465. fontSizeSetting: string;
  1466. /**
  1467. * 客户端基础库版本
  1468. */
  1469. SDKVersion: string;
  1470. /**
  1471. * 性能等级
  1472. */
  1473. benchmarkLevel: number;
  1474. /**
  1475. * 电量,范围 1 - 100
  1476. */
  1477. battery: number;
  1478. /**
  1479. * wifi 信号强度,范围 0 - 4
  1480. */
  1481. wifiSignal: number;
  1482. }
  1483. // --触摸对象
  1484. interface Touch {
  1485. /**
  1486. * Touch 对象的唯一标识符,只读属性。一次触摸动作(我们值的是手指的触摸)在平面上移动的整个过程中, 该标识符不变。可以根据它来判断跟踪的是否是同一次触摸过程。
  1487. */
  1488. identifier: number;
  1489. /**
  1490. * 触点相对于整体页面的 X 轴距离。
  1491. */
  1492. pageX: number;
  1493. /**
  1494. * 触点相对于整体页面的 Y 轴距离。
  1495. */
  1496. pageY: number;
  1497. /**
  1498. * 触点相对于游戏窗口的 X 轴距离。
  1499. */
  1500. clientX: number;
  1501. /**
  1502. * 触点相对于游戏窗口的 Y 轴距离。
  1503. */
  1504. clientY: number;
  1505. }
  1506. interface TouchData {
  1507. /**
  1508. * 当前事件的类型
  1509. */
  1510. type: string;
  1511. /**
  1512. * 当前所有触摸点的列表
  1513. */
  1514. touches: ReadonlyArray<Touch>;
  1515. /**
  1516. * 触发此次事件的触摸点列表
  1517. */
  1518. changedTouches: ReadonlyArray<Touch>;
  1519. /**
  1520. * 事件触发时的时间戳
  1521. */
  1522. timeStamp: number;
  1523. }
  1524. // --iBeacon(TODO)
  1525. /**
  1526. * 停止搜索附近的 iBeacon 设备
  1527. */
  1528. function stopBeaconDiscovery(param: unknown): void;
  1529. /**
  1530. * 开始搜索附近的 iBeacon 设备
  1531. */
  1532. function startBeaconDiscovery(param: unknown): void;
  1533. /**
  1534. * 监听 iBeacon 设备更新事件,仅能注册一个监听
  1535. */
  1536. function onBeaconUpdate(callback: unknown): void;
  1537. /**
  1538. * 监听 iBeacon 服务状态变化事件,仅能注册一个监听
  1539. */
  1540. function onBeaconServiceChange(callback: unknown): void;
  1541. /**
  1542. * 取消监听 iBeacon 设备更新事件
  1543. */
  1544. function offBeaconUpdate(callback: unknown): void;
  1545. /**
  1546. * 取消监听 iBeacon 服务状态变化事件
  1547. */
  1548. function offBeaconServiceChange(callback: unknown): void;
  1549. /**
  1550. * 获取所有已搜索到的 iBeacon 设备
  1551. */
  1552. function getBeacons(param: unknown): void;
  1553. /*
  1554. IBeaconInfo
  1555. 属性
  1556. string uuid
  1557. iBeacon 设备广播的 uuid
  1558. string major
  1559. iBeacon 设备的主 id
  1560. string minor
  1561. iBeacon 设备的次 id
  1562. number proximity
  1563. 表示设备距离的枚举值
  1564. number accuracy
  1565. iBeacon 设备的距离
  1566. number rssi
  1567. 表示设备的信号强度
  1568. */
  1569. // --低功耗蓝牙(TODO)
  1570. function writeBLECharacteristicValue(): void;
  1571. function readBLECharacteristicValue(): void;
  1572. function onBLEConnectionStateChange(): void;
  1573. function onBLECharacteristicValueChange(): void;
  1574. function notifyBLECharacteristicValueChange(): void;
  1575. function getBLEDeviceServices(): void;
  1576. function getBLEDeviceCharacteristics(): void;
  1577. function createBLEConnection(): void;
  1578. function closeBLEConnection(): void;
  1579. // --蓝牙(TODO)
  1580. function stopBluetoothDevicesDiscovery(): void;
  1581. function startBluetoothDevicesDiscovery(): void;
  1582. function openBluetoothAdapter(): void;
  1583. function onBluetoothDeviceFound(): void;
  1584. function onBluetoothAdapterStateChange(): void;
  1585. function getConnectedBluetoothDevices(): void;
  1586. function getBluetoothDevices(): void;
  1587. function getBluetoothAdapterState(): void;
  1588. function closeBluetoothAdapter(): void;
  1589. // --电量
  1590. interface BatteryInfo {
  1591. /**
  1592. * 设备电量,范围 1 - 100
  1593. */
  1594. level: string;
  1595. /**
  1596. * 是否正在充电
  1597. */
  1598. isCharging: boolean;
  1599. }
  1600. // --剪切板
  1601. interface ClipboardData {
  1602. data: string;
  1603. }
  1604. interface SetClipboardDataParams {
  1605. success?: () => void;
  1606. fail?: () => void;
  1607. complete?: () => void;
  1608. data: string;
  1609. }
  1610. interface SetKeepScreenOnParams {
  1611. success?: () => void;
  1612. fail?: () => void;
  1613. complete?: () => void;
  1614. keepScreenOn: boolean;
  1615. }
  1616. interface SetScreenBrightnessParams {
  1617. success?: () => void;
  1618. fail?: () => void;
  1619. complete?: () => void;
  1620. /**
  1621. * 屏幕亮度值,范围 0 ~ 1,0 最暗,1 最亮
  1622. */
  1623. value: number;
  1624. }
  1625. interface DownfileParams {
  1626. url: string;
  1627. /**
  1628. * 在指定filePath之后success回调中将不会有res.tempFilePath路径值,下载的文件会直接写入filePath指定的路径(有写入权限的情况下,根目录请使用wx.env.USER_DATA_PATH,路径文件夹必须存在,否则写入失败)
  1629. */
  1630. filePath?: string;
  1631. /**
  1632. * HTTP 请求的 Header,Header 中不能设置 Referer
  1633. */
  1634. header?: { [key: string]: string };
  1635. /**
  1636. * res.tempFilePath 临时文件路径。如果没传入 filePath 指定文件存储路径,则下载后的文件会存储到一个临时文件
  1637. * res.statusCode 开发者服务器返回的 HTTP 状态码
  1638. */
  1639. success?: (res: { tempFilePath?: string, statusCode: number }) => void;
  1640. fail?: (res: { errMsg: string }) => void;
  1641. complete?: () => void;
  1642. }
  1643. type NetworkType = "wifi" | "2g" | "3g" | "4g" | "unknown" | "none";
  1644. type RequestMethod = "GET" | "HEAD" | "POST" | "PUT" | "DELETE" | "TRACE" | "CONNECT";
  1645. interface RequestParams {
  1646. /**
  1647. * 开发者服务器接口地址
  1648. */
  1649. url: string;
  1650. /**
  1651. * 请求的参数
  1652. */
  1653. data?: string | { [key: string]: any };
  1654. /**
  1655. * 设置请求的 header,header 中不能设置 Referer
  1656. */
  1657. header?: { [name: string]: string };
  1658. /**
  1659. * HTTP 请求方法
  1660. */
  1661. method?: RequestMethod;
  1662. /**
  1663. * 返回的数据格式
  1664. */
  1665. dataType?: "json" | "arraybuffer";
  1666. /**
  1667. * res.data usually can be string or ArrayBuffer
  1668. */
  1669. success?: (res: { data: any, statusCode: number, header?: { [key: string]: string } }) => void;
  1670. fail?: () => void;
  1671. complete?: () => void;
  1672. }
  1673. interface SocketSendParams {
  1674. data: string | ArrayBuffer;
  1675. success?: () => void;
  1676. fail?: () => void;
  1677. complete?: () => void;
  1678. }
  1679. interface SocketConnectParams {
  1680. url: string;
  1681. protocols?: string[];
  1682. header?: { [key: string]: string };
  1683. method?: RequestMethod;
  1684. success?: () => void;
  1685. fail?: () => void;
  1686. complete?: () => void;
  1687. }
  1688. interface SocketCloseParams {
  1689. /**
  1690. * 一个数字值表示关闭连接的状态号,表示连接被关闭的原因。如果这个参数没有被指定,默认的取值是1000 (表示正常连接关闭)
  1691. */
  1692. code?: number;
  1693. /**
  1694. * 一个可读的字符串,表示连接被关闭的原因。这个字符串必须是不长于123字节的UTF-8 文本(不是字符)
  1695. */
  1696. reason?: string;
  1697. success?: () => void;
  1698. fail?: () => void;
  1699. complete?: () => void;
  1700. }
  1701. type SocketOpenCallback = (res: { header?: { [key: string]: string } }) => void;
  1702. type SocketMessageCallback = (res: { data: string | ArrayBuffer }) => void;
  1703. type SocketErrorCallback = (res: { errMsg: string }) => void;
  1704. interface UDPSendParams {
  1705. /**
  1706. * 要发消息的地址。可以是一个和本机同网段的 IP 地址,也可以是在安全域名列表内的域名地址
  1707. */
  1708. address: string;
  1709. /**
  1710. * 要发送消息的端口号
  1711. */
  1712. port: number;
  1713. /**
  1714. * 要发送的数据
  1715. */
  1716. message: string | ArrayBuffer;
  1717. /**
  1718. * 发送数据的偏移量,仅当 message 为 ArrayBuffer 类型时有效,默认值0
  1719. */
  1720. offset?: number;
  1721. /**
  1722. * 发送数据的长度,仅当 message 为 ArrayBuffer 类型时有效,默认值message.byteLength
  1723. */
  1724. length?: number;
  1725. }
  1726. interface UDPMessage {
  1727. /**
  1728. * 收到的消息
  1729. */
  1730. message: ArrayBuffer;
  1731. /**
  1732. * 消息来源的结构化信息
  1733. */
  1734. remoteInfo: {
  1735. /**
  1736. * 发送消息的 socket 的地址
  1737. */
  1738. address: string;
  1739. /**
  1740. * 使用的协议族,为 IPv4 或者 IPv6
  1741. */
  1742. family: string;
  1743. /**
  1744. * 端口号
  1745. */
  1746. port: number;
  1747. /**
  1748. * message 的大小,单位:字节
  1749. */
  1750. size: number;
  1751. };
  1752. }
  1753. /**
  1754. * wx.getUserInfo的旧版本API参数,随时会被删除,不推荐使用
  1755. */
  1756. interface OldUserInfoParam {
  1757. /**
  1758. * 是否带上登录态信息。当 withCredentials 为 true 时,要求此前有调用过 wx.login 且登录态尚未过期,此时返回的数据会包含 encryptedData, iv 等敏感信息;当 withCredentials 为 false 时,不要求有登录态,返回的数据不包含 encryptedData, iv 等敏感信息。
  1759. */
  1760. withCredentials?: boolean;
  1761. /**
  1762. * 显示用户信息的语言
  1763. */
  1764. lang?: "en" | "zh_CN" | "zh_TW";
  1765. success?: (res: {
  1766. /**
  1767. * 用户信息对象,不包含 openid 等敏感信息
  1768. */
  1769. userInfo: UserInfo,
  1770. /**
  1771. * 不包括敏感信息的原始数据字符串,用于计算签名
  1772. */
  1773. rawData: string,
  1774. /**
  1775. * 使用 sha1( rawData + sessionkey ) 得到字符串,用于校验用户信息,参考文档signature(https://mp.weixin.qq.com/debug/wxagame/dev/tutorial/open-ability/http-signature.html?t=201822)
  1776. */
  1777. signature: string,
  1778. /**
  1779. * 包括敏感数据在内的完整用户信息的加密数据,详见加密数据解密算法(https://mp.weixin.qq.com/debug/wxagame/dev/tutorial/open-ability/signature.html?t=201822)
  1780. */
  1781. encryptedData: string,
  1782. /**
  1783. * 加密算法的初始向量,详见加密数据解密算法(https://mp.weixin.qq.com/debug/wxagame/dev/tutorial/open-ability/signature.html?t=201822)
  1784. */
  1785. iv: string,
  1786. errMsg: string
  1787. }) => void;
  1788. fail?: () => void;
  1789. complete?: () => void;
  1790. }
  1791. /**
  1792. * 新版本wx.getUserInfo的参数,需要在开放数据域内调用
  1793. */
  1794. interface NewUserInfoParam {
  1795. /**
  1796. * 要获取信息的用户的 openId 数组,如果要获取当前用户信息,则将数组中的一个元素设为 'selfOpenId'
  1797. */
  1798. openIdList?: string[];
  1799. /**
  1800. * 显示用户信息的语言
  1801. */
  1802. lang?: "en" | "zh_CN" | "zh_TW";
  1803. success?: (res: { data: ReadonlyArray<UserInfo> }) => void;
  1804. fail?: () => void;
  1805. complete?: () => void;
  1806. }
  1807. interface UserInfo {
  1808. language: string;
  1809. nickName: string;
  1810. avatarUrl: string;
  1811. /**
  1812. * 0:未知、1:男、2:女
  1813. */
  1814. gender: 0 | 1 | 2;
  1815. country: string;
  1816. province: string;
  1817. city: string;
  1818. }
  1819. type ButtonType = "text" | "image";
  1820. interface ButtonStyle {
  1821. left?: number;
  1822. top?: number;
  1823. width?: number;
  1824. height?: number;
  1825. /**
  1826. * 格式#ff0000
  1827. */
  1828. backgroundColor?: string;
  1829. /**
  1830. * 格式#ff0000
  1831. */
  1832. borderColor?: string;
  1833. borderWidth?: number;
  1834. borderRadius?: number;
  1835. textAlign?: "left" | "center" | "right";
  1836. fontSize?: number;
  1837. lineHeight?: number;
  1838. }
  1839. type GameClubButtonIcon = "green" | "white" | "dark" | "light";
  1840. // --设置
  1841. interface AuthSetting {
  1842. /**
  1843. * 用户信息,对应接口 wx.getUserInfo
  1844. */
  1845. "scope.userInfo"?: boolean;
  1846. /**
  1847. * 地理位置,对应接口 wx.getLocation wx.chooseLocation
  1848. */
  1849. "scope.userLocation"?: boolean;
  1850. /**
  1851. * 通讯地址,对应接口 wx.chooseAddress
  1852. */
  1853. "scope.address"?: boolean;
  1854. /**
  1855. * 发票抬头,对应接口 wx.chooseInvoiceTitle
  1856. */
  1857. "scope.invoiceTitle"?: boolean;
  1858. /**
  1859. * 微信运动步数,对应接口 wx.getWeRunData
  1860. */
  1861. "scope.werun"?: boolean;
  1862. /**
  1863. * 录音功能,对应接口 wx.startRecord
  1864. */
  1865. "scope.record"?: boolean;
  1866. /**
  1867. * 保存到相册 wx.saveImageToPhotosAlbum, wx.saveVideoToPhotosAlbum
  1868. */
  1869. "scope.writePhotosAlbum"?: boolean;
  1870. /**
  1871. * 摄像头 wx.camera
  1872. */
  1873. "scope.camera"?: boolean;
  1874. }
  1875. interface SetStorageParams {
  1876. key: string;
  1877. data: any;
  1878. success?: () => void;
  1879. fail?: () => void;
  1880. complete?: () => void;
  1881. }
  1882. interface RemoveStorageParams {
  1883. key: string;
  1884. success?: () => void;
  1885. fail?: () => void;
  1886. complete?: () => void;
  1887. }
  1888. interface GetStorageParams {
  1889. key: string;
  1890. success?: (res: { data: any }) => void;
  1891. fail?: () => void;
  1892. complete?: () => void;
  1893. }
  1894. interface StorageInfo {
  1895. /**
  1896. * 当前 storage 中所有的 key
  1897. */
  1898. keys: ReadonlyArray<string>;
  1899. /**
  1900. * 当前占用的空间大小, 单位 KB
  1901. */
  1902. currentSize: number;
  1903. /**
  1904. * 限制的空间大小,单位 KB
  1905. */
  1906. limitSize: number;
  1907. }
  1908. interface ShareOption {
  1909. /**
  1910. * 转发标题,不传则默认使用当前小游戏的昵称。
  1911. */
  1912. title?: string;
  1913. /**
  1914. * 转发显示图片的链接,可以是网络图片路径或本地图片文件路径或相对代码包根目录的图片文件路径。显示图片长宽比是 5:4
  1915. */
  1916. imageUrl?: string;
  1917. /**
  1918. * 查询字符串,必须是 key1=val1&key2=val2 的格式。从这条转发消息进入后,可通过 wx.getLaunchOptionsSync() 或 wx.onShow 获取启动参数中的 query。
  1919. */
  1920. query?: string;
  1921. /**
  1922. * 是否转发到当前群。该参数只对从群工具栏打开的场景下生效,默认转发到当前群,填入false时可转发到其他会话
  1923. */
  1924. toCurrentGroup?: boolean;
  1925. }
  1926. interface AccelerometerParams {
  1927. interval: "game" | "ui" | "normal";
  1928. success?: () => void;
  1929. fail?: () => void;
  1930. complete?: () => void;
  1931. }
  1932. type AudioSourceType = "auto" | "buildInMic" | "headsetMic" | "mic" | "camcorder";
  1933. interface AdStyle {
  1934. /**
  1935. * 广告组件的左上角横坐标
  1936. */
  1937. left: number;
  1938. /**
  1939. * banner 广告组件的左上角纵坐标
  1940. */
  1941. top: number;
  1942. /**
  1943. * banner 广告组件的宽度。最小 300,最大至 屏幕宽度(屏幕宽度可以通过 wx.getSystemInfoSync() 获取)。
  1944. */
  1945. width: number;
  1946. /**
  1947. * banner 广告组件的高度
  1948. */
  1949. height: number;
  1950. /**
  1951. * banner 广告组件经过缩放后真实的宽度
  1952. */
  1953. realWidth: number;
  1954. /**
  1955. * banner 广告组件经过缩放后真实的高度
  1956. */
  1957. realHeight: number;
  1958. }
  1959. }
  1960. /**
  1961. * 创建一个画布对象。首次调用创建的是显示在屏幕上的画布,之后调用创建的都是离屏画布。
  1962. */
  1963. function createCanvas(): Canvas;
  1964. /**
  1965. * 只有开放数据域能调用,获取主域和开放数据域共享的 sharedCanvas
  1966. */
  1967. function getSharedCanvas(): Canvas;
  1968. /**
  1969. * 创建一个图片对象
  1970. */
  1971. function createImage(): types.Image;
  1972. /**
  1973. * 获取一行文本的行高
  1974. * @param p 字体参数
  1975. */
  1976. function getTextLineHeight(p: types.LineHeightParams): number;
  1977. /**
  1978. * 加载自定义字体文件
  1979. * @param path 字体文件路径。可以是代码包文件路径,也可以是 wxfile:// 协议的本地文件路径。
  1980. */
  1981. function loadFont(path: string): string;
  1982. /**
  1983. * 可以修改渲染帧率。默认渲染帧率为 60 帧每秒。修改后,requestAnimationFrame 的回调频率会发生改变。
  1984. * @param fps 帧率,有效范围 1 - 60。
  1985. */
  1986. function setPreferredFramesPerSecond(fps: number): void;
  1987. // --生命周期
  1988. function exitMiniProgram(cb?: types.Callbacks): void;
  1989. function getLaunchOptionsSync(): types.LaunchOption;
  1990. function onHide(cb: () => void): void;
  1991. function offHide(cb: () => void): void;
  1992. function onShow(cb: (res: { scene: string, query: any, shareTicket: string }) => void): void;
  1993. function offShow(cb: (res: { scene: string, query: any, shareTicket: string }) => void): void;
  1994. // --系统信息
  1995. function getSystemInfo(cb: types.CallbacksWithType<types.SystemInfo>): void;
  1996. function getSystemInfoSync(): types.SystemInfo;
  1997. function getAccountInfoSync();
  1998. /**
  1999. * 监听音频中断结束,在收到 onAudioInterruptionBegin 事件之后,小程序内所有音频会暂停,收到此事件之后才可再次播放成功
  2000. */
  2001. function onAudioInterruptionEnd(cb: () => void): void;
  2002. /**
  2003. * 取消监听音频中断结束,在收到 onAudioInterruptionBegin 事件之后,小程序内所有音频会暂停,收到此事件之后才可再次播放成功
  2004. */
  2005. function offAudioInterruptionEnd(cb: () => void): void;
  2006. /**
  2007. * 监听音频因为受到系统占用而被中断开始,以下场景会触发此事件:闹钟、电话、FaceTime 通话、微信语音聊天、微信视频聊天。此事件触发后,小程序内所有音频会暂停。
  2008. */
  2009. function onAudioInterruptionBegin(cb: () => void): void;
  2010. /**
  2011. * 取消监听音频因为受到系统占用而被中断开始,以下场景会触发此事件:闹钟、电话、FaceTime 通话、微信语音聊天、微信视频聊天。此事件触发后,小程序内所有音频会暂停。
  2012. */
  2013. function offAudioInterruptionBegin(cb: () => void): void;
  2014. /**
  2015. * 监听全局错误事件
  2016. */
  2017. function onError(cb: (res: { message: string, stack: string }) => void): void;
  2018. function offError(cb: (res: { message: string, stack: string }) => void): void;
  2019. // --触摸事件
  2020. /**
  2021. * 监听开始始触摸事件
  2022. */
  2023. function onTouchStart(cb: (res: types.TouchData) => void): void;
  2024. function offTouchStart(cb: (res: types.TouchData) => void): void;
  2025. /**
  2026. * 监听触点移动事件
  2027. */
  2028. function onTouchMove(cb: (res: types.TouchData) => void): void;
  2029. function offTouchMove(cb: (res: types.TouchData) => void): void;
  2030. /**
  2031. * 监听触摸结束事件
  2032. */
  2033. function onTouchEnd(cb: (res: types.TouchData) => void): void;
  2034. function offTouchEnd(cb: (res: types.TouchData) => void): void;
  2035. /**
  2036. * 监听触点失效事件
  2037. */
  2038. function onTouchCancel(cb: (res: types.TouchData) => void): void;
  2039. function offTouchCancel(cb: (res: types.TouchData) => void): void;
  2040. // --加速计
  2041. /**
  2042. * 监听加速度数据,频率:5次/秒,接口调用后会自动开始监听,可使用 wx.stopAccelerometer 停止监听。
  2043. */
  2044. function onAccelerometerChange(cb: (res: { x: number, y: number, z: number }) => void): void;
  2045. /**
  2046. * 开始监听加速度数据。
  2047. */
  2048. function startAccelerometer(cb: types.AccelerometerParams): void;
  2049. /**
  2050. * 停止监听加速度数据。
  2051. */
  2052. function stopAccelerometer(cb?: types.Callbacks): void;
  2053. // --电量
  2054. /**
  2055. * 获取设备电量。同步 API wx.getBatteryInfoSync 在 iOS 上不可用。
  2056. */
  2057. function getBatteryInfo(cb: types.CallbacksWithType<types.BatteryInfo>): void;
  2058. /**
  2059. * IOS上这个同步API无法使用
  2060. */
  2061. function getBatteryInfoSync(): types.BatteryInfo;
  2062. // --剪贴板
  2063. /**
  2064. * 取得系统剪贴板的内容
  2065. */
  2066. function getClipboardData(cb: types.CallbacksWithType<types.ClipboardData>): void;
  2067. /**
  2068. * 设置系统剪贴板的内容
  2069. */
  2070. function setClipboardData(p: types.SetClipboardDataParams): void;
  2071. // --罗盘
  2072. /**
  2073. * 监听罗盘数据,频率:5 次/秒,接口调用后会自动开始监听,可使用 wx.stopCompass 停止监听。
  2074. * @param cb.res.direction 面对的方向度数
  2075. */
  2076. function onCompassChange(cb: (res: { direction: number }) => void): void;
  2077. /**
  2078. * 开始监听罗盘数据
  2079. */
  2080. function startCompass(cb?: types.Callbacks): void;
  2081. /**
  2082. * 停止监听罗盘数据
  2083. */
  2084. function stopCompass(cb?: types.Callbacks): void;
  2085. // --网络
  2086. /**
  2087. * 获取网络类型
  2088. */
  2089. function getNetworkType(cb: types.CallbacksWithType<{ isConnected: boolean, networkType: types.NetworkType }>): void;
  2090. /**
  2091. * 监听网络状态变化事件
  2092. */
  2093. function onNetworkStatusChange(cb: (res: {
  2094. /**
  2095. * 当前是否有网络链接
  2096. */
  2097. isConnected: boolean,
  2098. /**
  2099. * none - 无网络, unknown - Android 下不常见的网络类型
  2100. */
  2101. networkType: types.NetworkType
  2102. }) => void): void;
  2103. // --屏幕
  2104. /**
  2105. * 获取屏幕亮度
  2106. */
  2107. function getScreenBrightness(cb: types.CallbacksWithType<{ value: number }>): void;
  2108. /**
  2109. * 设置是否保持常亮状态。仅在当前小程序生效,离开小程序后设置失效。
  2110. */
  2111. function setKeepScreenOn(p: types.SetKeepScreenOnParams): void;
  2112. /**
  2113. * 设置屏幕亮度
  2114. */
  2115. function setScreenBrightness(p: types.SetScreenBrightnessParams): void;
  2116. // --转屏
  2117. /**
  2118. * 监听横竖屏切换事件
  2119. */
  2120. function onDeviceOrientationChange(callback: (res: { value: string }) => void): void;
  2121. /**
  2122. * 取消监听横竖屏切换事件
  2123. */
  2124. function offDeviceOrientationChange(callback: (res: { value: string }) => void): void;
  2125. // --设备方向
  2126. /**
  2127. * 停止监听设备方向的变化。
  2128. */
  2129. function stopDeviceMotionListening(cb?: types.Callbacks): void;
  2130. /**
  2131. * 开始监听设备方向的变化
  2132. */
  2133. function startDeviceMotionListening(param: {
  2134. /**
  2135. * 开始监听设备方向的变化。默认值normal,
  2136. * game - 适用于更新游戏的回调频率,在 20ms/次 左右
  2137. * ui - 适用于更新 UI 的回调频率,在 60ms/次 左右
  2138. * normal - 普通的回调频率,在 200ms/次 左右
  2139. */
  2140. interval: "game" | "ui" | "normal"
  2141. } & types.Callbacks): void;
  2142. /**
  2143. * 监听设备方向变化事件。频率根据 wx.startDeviceMotionListening() 的 interval 参数。可以使用 wx.stopDeviceMotionListening() 停止监听。
  2144. */
  2145. function onDeviceMotionChange(callback: (res: {
  2146. /**
  2147. * 当 手机坐标 X/Y 和 地球 X/Y 重合时,绕着 Z 轴转动的夹角为 alpha,范围值为 [0, 2*PI)。逆时针转动为正。
  2148. */
  2149. alpha: number,
  2150. /**
  2151. * 当手机坐标 Y/Z 和地球 Y/Z 重合时,绕着 X 轴转动的夹角为 beta。范围值为 [-1*PI, PI) 。顶部朝着地球表面转动为正。也有可能朝着用户为正。
  2152. */
  2153. beta: number,
  2154. /**
  2155. * 当手机 X/Z 和地球 X/Z 重合时,绕着 Y 轴转动的夹角为 gamma。范围值为 [-1*PI/2, PI/2)。右边朝着地球表面转动为正。
  2156. */
  2157. gamma: number
  2158. }) => void): void;
  2159. /**
  2160. * 取消监听设备方向变化事件,参数为空,则取消所有的事件监听。
  2161. * @param callback 之前添加过的监听回调函数,如果不指定,则清空所有
  2162. */
  2163. function offDeviceMotionChange(callback?: unknown): void;
  2164. // --陀螺仪
  2165. /**
  2166. * 停止监听陀螺仪数据
  2167. */
  2168. function stopGyroscope(cb?: types.Callbacks): void;
  2169. /**
  2170. * 开始监听陀螺仪数据。
  2171. */
  2172. function startGyroscope(param: {
  2173. /**
  2174. * 开始监听设备方向的变化。默认值normal,
  2175. * game - 适用于更新游戏的回调频率,在 20ms/次 左右
  2176. * ui - 适用于更新 UI 的回调频率,在 60ms/次 左右
  2177. * normal - 普通的回调频率,在 200ms/次 左右
  2178. */
  2179. interval: "game" | "ui" | "normal"
  2180. } & types.Callbacks): void;
  2181. /**
  2182. * 监听陀螺仪数据变化事件。频率根据 wx.startGyroscope() 的 interval 参数。可以使用 wx.stopGyroscope() 停止监听。
  2183. * @param callback 监听函数
  2184. */
  2185. function onGyroscopeChange(callback: (res: {
  2186. /**
  2187. * x 轴的角速度
  2188. */
  2189. x: number,
  2190. /**
  2191. * y 轴的角速度
  2192. */
  2193. y: number,
  2194. /**
  2195. * z 轴的角速度
  2196. */
  2197. z: number
  2198. }) => void): void;
  2199. /**
  2200. * 取消监听陀螺仪数据变化事件。
  2201. * @param callback 之前监听的回调函数
  2202. */
  2203. function offGyroscopeChange(callback: unknown): void;
  2204. // --振动
  2205. /**
  2206. * 使手机发生较短时间的振动(15 ms)
  2207. */
  2208. function vibrateShort(cb?: types.Callbacks): void;
  2209. /**
  2210. * 使手机发生较长时间的振动(400 ms)
  2211. */
  2212. function vibrateLong(cb?: types.Callbacks): void;
  2213. // --文件系统
  2214. function getFileSystemManager(): FileSystemManager;
  2215. // --推荐弹窗
  2216. /**
  2217. * 创建小游戏推荐弹窗组件。请通过 wx.getSystemInfoSync() 返回对象的 SDKVersion 判断基础库版本号 >= 2.7.5 后再使用该 API。每次调用该方法都会返回一个全新的实例。
  2218. */
  2219. function createGamePortal(param: {
  2220. /**
  2221. * 推荐单元 id
  2222. */
  2223. adUnitId: string
  2224. }): unknown /* GamePortal */; // TODO: GamePortal
  2225. /**
  2226. * 创建小游戏推荐icon组件。请通过 wx.getSystemInfoSync() 返回对象的 SDKVersion 判断基础库版本号 >= 2.8.2 后再使用该 API。每次调用该方法都会返回一个全新的实例。
  2227. */
  2228. function createGameIcon(param: {
  2229. /**
  2230. * 推荐单元 id
  2231. */
  2232. adUnitId: string,
  2233. /**
  2234. * 游戏icon的数量,请注意,正式版下面渲染出来的icon数量会小于等于count,请注册做好样式兼容
  2235. */
  2236. count: number,
  2237. /**
  2238. * 数组的每一项可以针对对应的icon设置位置和样式等信息,style的每一项称为styleItem
  2239. */
  2240. style: ReadonlyArray<{
  2241. /**
  2242. * 游戏名称是否隐藏
  2243. */
  2244. appNameHidden: boolean,
  2245. /**
  2246. * 游戏名称的颜色色值
  2247. */
  2248. color: string,
  2249. /**
  2250. * 游戏icon的宽高值
  2251. */
  2252. size: number,
  2253. /**
  2254. * 游戏icon的border尺寸
  2255. */
  2256. borderWidth: number,
  2257. /**
  2258. * 游戏icon的border颜色色值
  2259. */
  2260. borderColor: string,
  2261. /**
  2262. * 游戏icon的X轴坐标
  2263. */
  2264. left: number,
  2265. /**
  2266. * 游戏icon的Y轴坐标
  2267. */
  2268. top: number
  2269. }>
  2270. }): unknown /* GameIcon */; // TODO: GameIcon
  2271. /**
  2272. * 创建小游戏推荐banner组件。请通过 wx.getSystemInfoSync() 返回对象的 SDKVersion 判断基础库版本号 >= 2.7.5 后再使用该 API。每次调用该方法都会返回一个全新的实例。
  2273. */
  2274. function createGameBanner(param: {
  2275. /**
  2276. * 推荐单元 id
  2277. */
  2278. adUnitId: string,
  2279. /**
  2280. * 小游戏推荐banner组件样式
  2281. */
  2282. style: {
  2283. /**
  2284. * 小游戏推荐banner组件左上角横坐标
  2285. */
  2286. left: number,
  2287. /**
  2288. * 小游戏推荐banner组件左上角纵坐标
  2289. */
  2290. top: number
  2291. }
  2292. }): unknown /* GameBanner */; // TODO: GameBanner
  2293. // --游戏对局回放
  2294. /**
  2295. * 获取全局唯一的游戏画面录制对象
  2296. */
  2297. function getGameRecorder(): unknown /* GameRecorder */; // TODO: GameRecorder
  2298. /**
  2299. * 创建游戏对局回放分享按钮,返回一个单例对象。按钮在被用户点击后会发起对最近一次录制完成的游戏对局回放的分享。
  2300. */
  2301. function createGameRecorderShareButton(): unknown /* GameRecorderShareButton */; // TODO: GameRecorderShareButton
  2302. // --第三方平台
  2303. /**
  2304. * 获取第三方平台自定义的数据字段。
  2305. * Tips: 本接口暂时无法通过 wx.canIUse 判断是否兼容,开发者需要自行判断 wx.getExtConfig 是否存在来兼容,示例:
  2306. * if (wx.getExtConfig) {
  2307. * wx.getExtConfig({
  2308. * success (res) {
  2309. * console.log(res.extConfig)
  2310. * }
  2311. * })
  2312. * }
  2313. */
  2314. function getExtConfig(callbacks: types.CallbacksWithType<{
  2315. /**
  2316. * 第三方平台自定义的数据
  2317. */
  2318. extConfig: unknown
  2319. }>): void;
  2320. /**
  2321. * wx.getExtConfig 的同步版本。
  2322. */
  2323. function getExtConfigSync(): unknown;
  2324. /**
  2325. * 系统环境变量
  2326. */
  2327. const env: {
  2328. /**
  2329. * 用户下载数据根目录
  2330. */
  2331. USER_DATA_PATH: string
  2332. };
  2333. // --位置
  2334. /**
  2335. * 获取当前的地理位置、速度。当用户离开小程序后,此接口无法调用;当用户点击“显示在聊天顶部”时,此接口可继续调用。
  2336. */
  2337. function getLocation(param: {
  2338. /**
  2339. * wgs84 返回 gps 坐标,gcj02 返回可用于 wx.openLocation 的坐标
  2340. */
  2341. type?: "wgs84" | "gcj02",
  2342. /**
  2343. * 传入 true 会返回高度信息,由于获取高度需要较高精确度,会减慢接口返回速度 >= 1.6.0
  2344. */
  2345. altitude?: boolean,
  2346. /**
  2347. * 开启高精度定位 >= 2.9.0
  2348. */
  2349. isHighAccuracy?: boolean,
  2350. /**
  2351. * 高精度定位超时时间(ms),指定时间内返回最高精度,该值3000ms以上高精度定位才有效果 >= 2.9.0
  2352. */
  2353. highAccuracyExpireTime?: number,
  2354. success?: (res: {
  2355. /**
  2356. * 纬度,范围为 -90~90,负数表示南纬
  2357. */
  2358. latitude: number,
  2359. /**
  2360. * 经度,范围为 -180~180,负数表示西经
  2361. */
  2362. longitude: number,
  2363. /**
  2364. * 速度,单位 m/s
  2365. */
  2366. speed: number,
  2367. /**
  2368. * 位置的精确度
  2369. */
  2370. accuracy: number,
  2371. /**
  2372. * 高度,单位 m
  2373. */
  2374. altitude: number,
  2375. /**
  2376. * 垂直精度,单位 m(Android 无法获取,返回 0)
  2377. */
  2378. verticalAccuracy: number,
  2379. /**
  2380. * 水平精度,单位 m
  2381. */
  2382. horizontalAccuracy: number
  2383. }) => void,
  2384. fail?: () => void,
  2385. complete?: () => void
  2386. }): void;
  2387. function getFuzzyLocation(param: {
  2388. /**
  2389. * wgs84 返回 gps 坐标,gcj02 返回可用于 wx.openLocation 的坐标
  2390. */
  2391. type?: "wgs84" | "gcj02",
  2392. success?: (res: {
  2393. /**
  2394. * 纬度,范围为 -90~90,负数表示南纬
  2395. */
  2396. latitude: number,
  2397. /**
  2398. * 经度,范围为 -180~180,负数表示西经
  2399. */
  2400. longitude: number,
  2401. }) => void,
  2402. fail?: (res) => void,
  2403. complete?: (res) => void
  2404. }): void;
  2405. // --网络
  2406. /**
  2407. * 下载文件
  2408. */
  2409. function downloadFile(param: types.DownfileParams): DownloadTask;
  2410. // --发起请求
  2411. function request(param: types.RequestParams): RequestTask;
  2412. // --websocket
  2413. /**
  2414. * 创建一个 WebSocket 连接。最多同时存在 5 个 WebSocket 连接。
  2415. */
  2416. function connectSocket(param: types.SocketConnectParams): SocketTask;
  2417. /**
  2418. * 关闭WebSocket
  2419. */
  2420. function closeSocket(param: types.SocketCloseParams): void;
  2421. /**
  2422. * 监听WebSocket 连接打开事件
  2423. */
  2424. function onSocketOpen(callback: types.SocketOpenCallback): void;
  2425. /**
  2426. * 监听WebSocket 连接关闭事件
  2427. */
  2428. function onSocketClose(callback: () => void): void;
  2429. /**
  2430. * 监听WebSocket 接受到服务器的消息事件
  2431. */
  2432. function onSocketMessage(callback: types.SocketMessageCallback): void;
  2433. /**
  2434. * 监听WebSocket 错误事件
  2435. */
  2436. function onSocketError(callback: types.SocketErrorCallback): void;
  2437. /**
  2438. * 通过 WebSocket 连接发送数据,需要先 wx.connectSocket,并在 wx.onSocketOpen 回调之后才能发送。
  2439. */
  2440. function sendSocketMessage(param: types.SocketSendParams): void;
  2441. // --UDP通信
  2442. /**
  2443. * 创建一个 UDP Socket 实例
  2444. */
  2445. function createUDPSocket(): UDPSocket;
  2446. // --上传
  2447. function uploadFile(param: {
  2448. /**
  2449. * 开发者服务器地址
  2450. */
  2451. url: string,
  2452. /**
  2453. * 要上传文件资源的路径
  2454. */
  2455. filePath: string,
  2456. /**
  2457. * 文件对应的 key,开发者在服务端可以通过这个 key 获取文件的二进制内容
  2458. */
  2459. name: string,
  2460. /**
  2461. * HTTP 请求 Header,Header 中不能设置 Referer
  2462. */
  2463. header?: { [key: string]: string },
  2464. /**
  2465. * HTTP 请求中其他额外的 form data
  2466. */
  2467. formData?: { [key: string]: any },
  2468. success?: (res: { data: string, statusCode: number }) => void,
  2469. fail?: () => void,
  2470. complete?: () => void
  2471. }): UploadTask;
  2472. // --开放数据
  2473. /**
  2474. * 拉取当前用户所有同玩好友的托管数据。该接口只可在开放数据域下使用
  2475. */
  2476. function getFriendCloudStorage(param: {
  2477. /**
  2478. * 要拉取的 key 列表
  2479. */
  2480. keyList: string[],
  2481. success?: (res: { data: ReadonlyArray<UserGameData> }) => void,
  2482. fail?: () => void,
  2483. complete?: () => void
  2484. }): void;
  2485. /**
  2486. * 获取当前用户托管数据当中对应 key 的数据。该接口只可在开放数据域下使用
  2487. */
  2488. function getUserCloudStorage(param: {
  2489. /**
  2490. * 要拉取的 key 列表
  2491. */
  2492. keyList: string[],
  2493. success?: (res: { KVDataList: ReadonlyArray<KVData> }) => void,
  2494. fail?: () => void,
  2495. complete?: () => void
  2496. }): void;
  2497. /**
  2498. * 在无须用户授权的情况下,批量获取用户信息。该接口只在开放数据域下可用
  2499. * 请注意!!旧版本的该接口已过期,微信不允许主动弹出授权框,旧版本API会被逐渐作废,请使用wx.createUserInfoButton或在隔离数据区取得用户信息
  2500. * 如使用旧接口取得用户信息,withCredentials 为 true 时需要先调用 wx.login 接口。需要用户授权 scope.userInfo
  2501. */
  2502. function getUserInfo(param: types.NewUserInfoParam | types.OldUserInfoParam): void;
  2503. /**
  2504. * 在小游戏是通过群分享卡片打开的情况下,可以通过调用该接口获取群同玩成员的游戏数据。该接口只可在开放数据域下使用。
  2505. */
  2506. function getGroupCloudStorage(param: {
  2507. /**
  2508. * 群分享对应的 shareTicket
  2509. */
  2510. shareTicket: string,
  2511. /**
  2512. * 要拉取的 key 列表
  2513. */
  2514. keyList: string[],
  2515. success?: (res: { data: ReadonlyArray<UserGameData> }) => void,
  2516. fail?: () => void,
  2517. complete?: () => void
  2518. }): void;
  2519. /**
  2520. * 删除用户托管数据当中对应 key 的数据。
  2521. */
  2522. function removeUserCloudStorage(param: {
  2523. /**
  2524. * 要删除掉 key 列表
  2525. */
  2526. keyList: string[],
  2527. success?: () => void,
  2528. fail?: () => void,
  2529. complete?: () => void
  2530. }): void;
  2531. /**
  2532. * 对用户托管数据进行写数据操作,允许同时写多组 KV 数据。
  2533. * 托管数据的限制
  2534. * > 每个openid所标识的微信用户在每个游戏上托管的数据不能超过128个key-value对。
  2535. * > 上报的key-value列表当中每一项的key+value长度都不能超过1K(1024)字节。
  2536. * > 上报的key-value列表当中每一个key长度都不能超过128字节。
  2537. */
  2538. function setUserCloudStorage(param: {
  2539. /**
  2540. * 要修改的 KV 数据列表
  2541. */
  2542. KVDataList: ReadonlyArray<KVData>,
  2543. success?: (e) => void,
  2544. fail?: (e) => void,
  2545. complete?: (e) => void
  2546. }): void;
  2547. /**
  2548. * 监听成功修改好友的互动型托管数据事件,该接口在游戏主域使用
  2549. * @param callback 事件发生的回调函数,只有一个参数为 wx.modifyFriendInteractiveStorage 传入的 key
  2550. */
  2551. function onInteractiveStorageModified(callback: (key: string) => void): void;
  2552. /**
  2553. * 修改好友的互动型托管数据,该接口只可在开放数据域下使用,示例代码:
  2554. * wx.modifyFriendInteractiveStorage({
  2555. * key: '1',
  2556. * opNum: 1,
  2557. * operation: 'add',
  2558. * toUser: '', // 好友的 openId
  2559. * title: '送你 10 个金币,赶快打开游戏看看吧', // 2.9.0 支持
  2560. * imageUrl: 'image/xxx' // 2.9.0 支持
  2561. * });
  2562. *
  2563. * 赠送动作的校验:
  2564. * 调用该接口需要上传 JSServer 函数 "checkInteractiveData",该函数可用于执行赠送动作的校验逻辑,校验通过后返回结果表示本次赠送是否合法。只有 checkInteractiveData 返回了 {ret: true},此次修改才会成功。
  2565. *
  2566. * 使用模板规则进行交互:
  2567. * 每次调用该接口会弹窗询问用户是否确认执行该操作,2.9.0 之后版本,需要在 game.json 中设置 modifyFriendInteractiveStorageTemplates 来定制交互的文案。
  2568. * modifyFriendInteractiveStorageTemplates是一个模板数组,每一个模板需要有 key, action, object 参数,还有一个可选参数 ratio,详细说明见示例配置:
  2569. * {
  2570. * "modifyFriendInteractiveStorageTemplates": [
  2571. * {
  2572. * "key": "1", // 这个 key 与接口中同名参数相对应,不同的 key 对应不同的模板
  2573. * "action": "赠送", // 互动行为
  2574. * "object": "金币", // 互动物品
  2575. * "ratio": 10 // 物品比率,opNum * ratio 代表物品个数
  2576. * }
  2577. * ]
  2578. * }
  2579. * 最后生成的文案为 "确认 ${action} ${nickname} ${object}?",或者 "确认 ${action} ${nickname} ${object} x ${opNum * ratio}?"
  2580. *
  2581. * 使用自定义文案进行交互:
  2582. * 2.7.7 之后,2.9.0 之前的版本,文案通过 game.json 的 modifyFriendInteractiveStorageConfirmWording 字段配置。 配置内容可包含 nickname 变量,用 ${nickname} 表示,实际调用时会被替换成好友的昵称。示例配置:
  2583. * {
  2584. * "modifyFriendInteractiveStorageConfirmWording": "确认送给${nickname}一个体力?"
  2585. * }
  2586. * 2.9.0 之后,在 modifyFriendInteractiveStorageTemplates 和 modifyFriendInteractiveStorageConfirmWording 都存在的情况下,会优先使用前者。
  2587. */
  2588. function modifyFriendInteractiveStorage(param: {
  2589. /**
  2590. * 需要修改的数据的 key,目前可以为 '1' - '50'
  2591. */
  2592. key: string,
  2593. /**
  2594. * 需要修改的数值,目前只能为 1
  2595. */
  2596. opNum: number,
  2597. /**
  2598. * 修改类型
  2599. */
  2600. operation: "add",
  2601. /**
  2602. * 目标好友的 openId
  2603. */
  2604. toUser?: string
  2605. /**
  2606. * 分享标题,如果设置了这个值,则在交互成功后自动询问用户是否分享给好友(需要配置模板规则)
  2607. */
  2608. title?: string
  2609. /**
  2610. * 分享图片地址,详见 wx.shareMessageToFriend 同名参数(需要配置模板规则)
  2611. */
  2612. imageUrl?: string,
  2613. /**
  2614. * 分享图片 ID,详见 wx.shareMessageToFriend 同名参数(需要配置模板规则)
  2615. */
  2616. imageUrlId?: string,
  2617. /**
  2618. * 是否静默修改(不弹框),静默修改需要用户通过快捷分享消息卡片进入才有效,代表分享反馈操作,无需填写 toUser,直接修改分享者与被分享者交互数据
  2619. * 默认值false
  2620. */
  2621. quiet?: boolean,
  2622. success?: () => void;
  2623. fail?: (res: {
  2624. /**
  2625. * 错误信息
  2626. */
  2627. errMsg: string,
  2628. /**
  2629. * 错误码
  2630. * -17006 非好友关系
  2631. * -17007 非法的 toUser openId
  2632. * -17008 非法的 key
  2633. * -17009 非法的 operation
  2634. * -17010 非法的操作数
  2635. * -17011 JSServer 校验写操作失败
  2636. */
  2637. errCode: number
  2638. }) => void;
  2639. complete?: () => void;
  2640. }): void;
  2641. /**
  2642. * 获取当前用户互动型托管数据对应 key 的数据
  2643. */
  2644. function getUserInteractiveStorage(param: {
  2645. /**
  2646. * 要获取的 key 列表
  2647. */
  2648. keyList: string[]
  2649. } & types.CallbacksWithType2<{
  2650. /**
  2651. * 加密数据,包含互动型托管数据的值。解密后的结果为一个 KVDataList,每一项为一个 KVData。 用户数据的签名验证和加解密
  2652. */
  2653. encryptedData: string,
  2654. /**
  2655. * 敏感数据对应的云 ID,开通云开发的小程序才会返回,可通过云调用直接获取开放数据,详细见云调用直接获取开放数据
  2656. */
  2657. cloudID: string
  2658. }, {
  2659. /**
  2660. * 错误信息
  2661. */
  2662. errMsg: string,
  2663. /**
  2664. * 错误码
  2665. * -17008 非法的 key
  2666. */
  2667. errCode: number
  2668. }>): void;
  2669. /**
  2670. * 获取可能对游戏感兴趣的未注册的好友名单。每次调用最多可获得 5 个好友,此接口只能在开放数据域中使用
  2671. */
  2672. function getPotentialFriendList(callback: types.CallbacksWithType<{
  2673. /**
  2674. * 可能对游戏感兴趣的未注册好友名单
  2675. */
  2676. list: ReadonlyArray<{
  2677. /**
  2678. * 用户的微信头像 url
  2679. */
  2680. avatarUrl: string,
  2681. /**
  2682. * 用户的微信昵称
  2683. */
  2684. nickname: string,
  2685. /**
  2686. * 用户 openid
  2687. */
  2688. openid: string
  2689. }>
  2690. }>): void;
  2691. // --登录
  2692. /**
  2693. * 通过 wx.login 接口获得的用户登录态拥有一定的时效性。用户越久未使用小程序,用户登录态越有可能失效。反之如果用户一直在使用小程序,则用户登录态一直保持有效。具体时效逻辑由微信维护,对开发者透明。开发者只需要调用 wx.checkSession 接口检测当前用户登录态是否有效。登录态过期后开发者可以再调用 wx.login 获取新的用户登录态。
  2694. */
  2695. function checkSession(cb: types.Callbacks): void;
  2696. /**
  2697. * 调用接口获取登录凭证(code)进而换取用户登录态信息,包括用户的唯一标识(openid) 及本次登录的 会话密钥(session_key)等。用户数据的加解密通讯需要依赖会话密钥完成。
  2698. */
  2699. function login(cb: types.CallbacksWithType<{
  2700. /**
  2701. * 用户登录凭证(有效期五分钟)。开发者需要在开发者服务器后台调用 code2accessToken,使用 code 换取 openid 和 session_key 等信息
  2702. */
  2703. code: string,
  2704. errMsg: string
  2705. }>): void;
  2706. // --防沉迷
  2707. /**
  2708. * 根据用户当天游戏时间判断用户是否需要休息
  2709. */
  2710. function checkIsUserAdvisedToRest(param: {
  2711. /**
  2712. * 今天已经玩游戏的时间,单位:秒
  2713. */
  2714. todayPlayedTime: number,
  2715. success?: (res: {
  2716. /**
  2717. * 是否建议用户休息
  2718. */
  2719. result: boolean
  2720. }) => void,
  2721. fail?: () => void,
  2722. complete?: () => void
  2723. }): void;
  2724. // --小程序跳转
  2725. /**
  2726. * 打开另一个小程序
  2727. * @param param 跳转参数
  2728. */
  2729. function navigateToMiniProgram(param: {
  2730. /**
  2731. * 要打开的小程序 appId
  2732. */
  2733. appId: string,
  2734. /**
  2735. * 打开的页面路径,如果为空则打开首页。path 中 ? 后面的部分会成为 query,在小程序的 App.onLaunch、App.onShow
  2736. * 和 Page.onLoad 的回调函数或小游戏的 wx.onShow 回调函数、wx.getLaunchOptionsSync 中可以获取到 query 数据。
  2737. * 对于小游戏,可以只传入 query 部分,来实现传参效果,如:传入 "?foo=bar"。
  2738. */
  2739. path?: string,
  2740. /**
  2741. * 需要传递给目标小程序的数据,目标小程序可在 App.onLaunch,App.onShow 中获取到这份数据。如果跳转的是小游戏,可以在 wx.onShow、wx.getLaunchOptionsSync 中可以获取到这份数据数据。
  2742. */
  2743. extraData?: unknown,
  2744. /**
  2745. * 要打开的小程序版本。仅在当前小程序为开发版或体验版时此参数有效。如果当前小程序是正式版,则打开的小程序必定是正式版。默认值release
  2746. * develop 开发版
  2747. * trial 体验版
  2748. * release 正式版
  2749. */
  2750. envVersion?: "develop" | "trial" | "release"
  2751. } & types.Callbacks): void;
  2752. // --用户信息
  2753. function createUserInfoButton(param: {
  2754. /**
  2755. * 按钮类型
  2756. */
  2757. type: types.ButtonType,
  2758. /**
  2759. * 按钮上的文本,仅当 type 为 text 时有效
  2760. */
  2761. text?: string,
  2762. /**
  2763. * 按钮的背景图片,仅当 type 为 image 时有效
  2764. */
  2765. image?: string,
  2766. /**
  2767. * 按钮的样式
  2768. */
  2769. style?: types.ButtonStyle,
  2770. /**
  2771. * 是否带上登录态信息。当 withCredentials 为 true 时,要求此前有调用过 wx.login 且登录态尚未过期,此时返回的数据会包含 encryptedData, iv 等敏感信息;当 withCredentials 为 false 时,不要求有登录态,返回的数据不包含 encryptedData, iv 等敏感信息。
  2772. */
  2773. withCredentials?: boolean,
  2774. lang?: "en" | "zh_CN" | "zh_TW"
  2775. }): UserInfoButton;
  2776. // --设置
  2777. /**
  2778. * 创建打开设置页面的按钮
  2779. */
  2780. function createOpenSettingButton(param: {
  2781. /**
  2782. * 按钮类型
  2783. */
  2784. type: types.ButtonType,
  2785. /**
  2786. * 按钮上的文本,仅当 type 为 text 时有效
  2787. */
  2788. text?: string,
  2789. /**
  2790. * 按钮的背景图片,仅当 type 为 image 时有效
  2791. */
  2792. image?: string,
  2793. /**
  2794. * 按钮的样式
  2795. */
  2796. style?: types.ButtonStyle
  2797. }): OpenSettingButton;
  2798. /**
  2799. * 获取用户的当前设置。返回值中只会出现小程序已经向用户请求过的权限。
  2800. */
  2801. function getSetting(p: types.CallbacksWithType<{ authSetting: types.AuthSetting }>): void;
  2802. /**
  2803. * 调起客户端小程序设置界面,返回用户设置的操作结果。设置界面只会出现小程序已经向用户请求过的权限。
  2804. */
  2805. function openSetting(p: types.CallbacksWithType<{ authSetting: types.AuthSetting }>): void;
  2806. // --微信运动
  2807. /**
  2808. * 获取用户过去三十天微信运动步数,需要先调用 wx.login 接口。需要用户授权 scope.werun。
  2809. */
  2810. function getWeRunData(p: types.CallbacksWithType<{
  2811. /**
  2812. * 包括敏感数据在内的完整用户信息的加密数据,详细见加密数据解密算法
  2813. */
  2814. encryptedData: string,
  2815. /**
  2816. * 加密算法的初始向量
  2817. */
  2818. iv: string
  2819. }>): void;
  2820. // --卡券
  2821. /**
  2822. * 查看微信卡包中的卡券。只有通过 认证 的小程序或文化互动类目的小游戏才能使用。更多文档请参考:微信卡券接口文档(https://mp.weixin.qq.com/cgi-bin/announce?action=getannouncement&key=1490190158&version=1&lang=zh_CN&platform=2)
  2823. */
  2824. function openCard(param: {
  2825. /**
  2826. * 需要打开的卡券列表
  2827. */
  2828. cardList: ReadonlyArray<{
  2829. /**
  2830. * 卡券 ID
  2831. */
  2832. cardId: string,
  2833. /**
  2834. * 由 wx.addCard 的返回对象中的加密 code 通过解密后得到,解密请参照:code 解码接口(https://developers.weixin.qq.com/doc/offiaccount/Cards_and_Offer/Coupons-Mini_Program_Start_Up.html)
  2835. */
  2836. code: string
  2837. }>
  2838. } & types.CallbacksWithType<unknown>): void; // TODO: success回调里的res的结构官方文档没写
  2839. /**
  2840. * 批量添加卡券。只有通过 认证 的小程序或文化互动类目的小游戏才能使用。更多文档请参考 微信卡券接口文档(https://mp.weixin.qq.com/cgi-bin/announce?action=getannouncement&key=1490190158&version=1&lang=zh_CN&platform=2)。
  2841. */
  2842. function addCard(param: {
  2843. /**
  2844. * 需要添加的卡券列表
  2845. */
  2846. cardList: ReadonlyArray<{
  2847. /**
  2848. * 卡券 ID
  2849. */
  2850. cardId: string,
  2851. /**
  2852. * 卡券的扩展参数。需将 CardExt 对象 JSON 序列化为字符串传入
  2853. */
  2854. cardExt: string
  2855. }>
  2856. } & types.CallbacksWithType<{
  2857. /**
  2858. * 卡券添加结果列表
  2859. */
  2860. cardList: ReadonlyArray<{
  2861. /**
  2862. * 加密 code,为用户领取到卡券的code加密后的字符串,解密请参照:code 解码接口
  2863. */
  2864. code: string,
  2865. /**
  2866. * 用户领取到卡券的 ID
  2867. */
  2868. cardId: string,
  2869. /**
  2870. * 卡券的扩展参数,值为一个 JSON 字符串
  2871. */
  2872. cardExt: string,
  2873. /**
  2874. * 是否成功
  2875. */
  2876. isSuccess: boolean
  2877. }>
  2878. }>): void;
  2879. // --授权
  2880. /**
  2881. * 提前向用户发起授权请求。调用后会立刻弹窗询问用户是否同意授权小程序使用某项功能或获取用户的某些数据,但不会实际调用对应接口。如果用户之前已经同意授权,则不会出现弹窗,直接返回成功。
  2882. */
  2883. function authorize(param: {
  2884. /**
  2885. * 需要获取权限的 scope
  2886. */
  2887. scope: string,
  2888. success?: () => void,
  2889. fail?: () => void,
  2890. complete?: () => void
  2891. }): void;
  2892. // --游戏圈
  2893. /**
  2894. * 创建游戏圈按钮。游戏圈按钮被点击后会跳转到小游戏的游戏圈。更多关于游戏圈的信息见 游戏圈使用指南
  2895. */
  2896. function createGameClubButton(param: {
  2897. type: types.ButtonType,
  2898. text?: string,
  2899. image?: string,
  2900. style?: types.ButtonStyle,
  2901. /**
  2902. * 游戏圈按钮的图标,仅当 object.type 参数为 image 时有效
  2903. */
  2904. icon?: types.GameClubButtonIcon
  2905. }): GameClubButton;
  2906. // --意见反馈
  2907. /**
  2908. * 用户点击后打开意见反馈页面的按钮
  2909. */
  2910. function createFeedbackButton(param: {
  2911. type: types.ButtonType,
  2912. text?: string,
  2913. image?: string,
  2914. style?: types.ButtonStyle
  2915. }): FeedbackButton;
  2916. // --客服消息
  2917. /**
  2918. * 进入客服会话,要求在用户发生过至少一次 touch 事件后才能调用。后台接入方式与小程序一致,详见 客服消息接入
  2919. */
  2920. function openCustomerServiceConversation(param: {
  2921. /**
  2922. * 会话来源
  2923. */
  2924. sessionFrom?: string,
  2925. /**
  2926. * 是否显示会话内消息卡片,设置此参数为 true,用户进入客服会话之后会收到一个消息卡片,通过以下三个参数设置卡片的内容
  2927. */
  2928. showMessageCard?: boolean,
  2929. /**
  2930. * 会话内消息卡片标题
  2931. */
  2932. sendMessageTitle?: string,
  2933. /**
  2934. * 会话内消息卡片路径
  2935. */
  2936. sendMessagePath?: string,
  2937. /**
  2938. * 会话内消息卡片图片路径
  2939. */
  2940. sendMessageImg?: string,
  2941. success?: () => void,
  2942. fail?: () => void,
  2943. complete?: () => void
  2944. }): void;
  2945. // --开放数据域
  2946. /**
  2947. * 获取开放数据域
  2948. */
  2949. function getOpenDataContext(): OpenDataContext;
  2950. /**
  2951. * 监听主域发送的消息
  2952. */
  2953. function onMessage(callback: (data: any) => void): void;
  2954. // --转发
  2955. /**
  2956. * 获取转发详细信息
  2957. */
  2958. function getShareInfo(param: {
  2959. shareTicket: string,
  2960. success?: (res: {
  2961. /**
  2962. * 错误信息
  2963. */
  2964. errMsg: string,
  2965. /**
  2966. * 包括敏感数据在内的完整转发信息的加密数据
  2967. */
  2968. encryptedData: string,
  2969. /**
  2970. * 加密算法的初始向量
  2971. */
  2972. iv: string
  2973. }) => void,
  2974. fail?: () => void,
  2975. complete?: () => void
  2976. }): void;
  2977. /**
  2978. * 隐藏转发按钮
  2979. */
  2980. function hideShareMenu(cb?: types.Callbacks): void;
  2981. /**
  2982. * 监听用户点击右上角菜单的“转发”按钮时触发的事件
  2983. */
  2984. function onShareAppMessage(cb: () => types.ShareOption): void;
  2985. /**
  2986. * 取消监听用户点击右上角菜单的“转发”按钮时触发的事件
  2987. */
  2988. function offShareAppMessage(cb: () => types.ShareOption): void;
  2989. /**
  2990. * 显示当前页面的转发按钮
  2991. */
  2992. function showShareMenu(param?: {
  2993. /**
  2994. * 是否使用带 shareTicket 的转发
  2995. */
  2996. withShareTicket: boolean,
  2997. menus: string[],
  2998. success?: () => void,
  2999. fail?: () => void,
  3000. complete?: () => void
  3001. }): void;
  3002. /**
  3003. * 分享到朋友圈
  3004. * @param param //分享参数
  3005. */
  3006. function onShareTimeline(param?: {
  3007. /**
  3008. * 转发标题,不传则默认使用当前小游戏的昵称。
  3009. */
  3010. title?: string,
  3011. /**
  3012. * 转发显示图片的链接,可以是网络图片路径或本地图片文件路径或相对代码包根目录的图片文件路径。显示图片长宽比是 5:4
  3013. */
  3014. imageUrl?: string
  3015. /**
  3016. * 审核通过的图片 ID,详见 使用审核通过的转发图片(https://developers.weixin.qq.com/minigame/dev/guide/open-ability/sh
  3017. * are/share.html#%E4%BD%BF%E7%94%A8%E5%AE%A1%E6%A0%B8%E9%80%9A%E8%BF%87%E7%9A%84%E8%BD%AC%E5%8F%91%E5%9B%BE%E7%89%87)
  3018. */
  3019. imageUrlId?: string
  3020. /**
  3021. * 朋友圈预览图链接,不传则默认使用当前游戏画面截图
  3022. */
  3023. imagePreviewUrl?: string
  3024. /**
  3025. * 审核通过的朋友圈预览图图片 ID,详见 使用审核通过的转发图片
  3026. */
  3027. imagePreviewUrlId?: string
  3028. /**
  3029. * 查询字符串,必须是 key1=val1&key2=val2 的格式。从这条转发消息进入后,
  3030. * 可通过 wx.getLaunchOptionsSync() 或 wx.onShow() 获取启动参数中的 query。不传则默认使用当前页面query。
  3031. */
  3032. query?: string
  3033. /**
  3034. * 独立分包路径。详见 小游戏独立分包指南
  3035. */
  3036. path?: string
  3037. }): void;
  3038. /**取消分享到朋友圈绑定的数据 */
  3039. function offShareTimeline();
  3040. /**
  3041. * 主动拉起转发,进入选择通讯录界面。
  3042. */
  3043. function shareAppMessage(param: types.ShareOption): void;
  3044. /**
  3045. * 设置 wx.shareMessageToFriend 接口 query 字段的值
  3046. * @param param 设置参数
  3047. * @returns 是否设置成功
  3048. */
  3049. function setMessageToFriendQuery(param: {
  3050. /**
  3051. * 需要传递的代表场景的数字,需要在 0 - 50 之间
  3052. */
  3053. shareMessageToFriendScene: number;
  3054. }): boolean;
  3055. /**
  3056. * 给指定的好友分享游戏信息,该接口只可在开放数据域下使用
  3057. * 定向分享不允许直接在开放数据域设置 query 参数 需要设置时请参见游戏域 wx.setMessageToFriendQuery 接口
  3058. * @param param 分享参数
  3059. */
  3060. function shareMessageToFriend(param: {
  3061. /**
  3062. * 发送对象的 openId
  3063. */
  3064. openId: string,
  3065. /**
  3066. * 转发标题,不传则默认使用当前小游戏的昵称。
  3067. */
  3068. title?: string,
  3069. /**
  3070. * 转发显示图片的链接,可以是网络图片路径或本地图片文件路径或相对代码包根目录的图片文件路径。显示图片长宽比是 5:4
  3071. */
  3072. imageUrl?: string
  3073. /**
  3074. * 审核通过的图片 ID,详见 使用审核通过的转发图片(https://developers.weixin.qq.com/minigame/dev/guide/open-ability/sh
  3075. * are/share.html#%E4%BD%BF%E7%94%A8%E5%AE%A1%E6%A0%B8%E9%80%9A%E8%BF%87%E7%9A%84%E8%BD%AC%E5%8F%91%E5%9B%BE%E7%89%87)
  3076. */
  3077. imageUrlId?: string
  3078. }): void;
  3079. /**
  3080. * 更新转发属性
  3081. */
  3082. function updateShareMenu(param: {
  3083. /**
  3084. * 是否使用带 shareTicket 的转发详情
  3085. */
  3086. withShareTicket: boolean,
  3087. success?: () => void,
  3088. fail?: () => void,
  3089. complete?: () => void
  3090. }): void;
  3091. // --性能
  3092. /**
  3093. * 获取性能管理器
  3094. */
  3095. function getPerformance(): WxPerformance;
  3096. /**
  3097. * 加快触发 JavaScriptCore Garbage Collection(垃圾回收),GC 时机是由 JavaScriptCore 来控制的,并不能保证调用后马上触发 GC。
  3098. */
  3099. function triggerGC(): void;
  3100. /**
  3101. * 监听内存不足告警
  3102. * @param callback.res.level 内存告警等级,只有 Android 才有,对应系统宏定义:
  3103. * 10 TRIM_MEMORY_RUNNING_LOW
  3104. * 15 TRIM_MEMORY_RUNNING_CRITICAL
  3105. */
  3106. function onMemoryWarning(callback: (res: { level: number }) => void): void;
  3107. /**
  3108. * 标记自定义场景
  3109. * @param sceneId 在管理后台配置过的场景ID
  3110. */
  3111. function markScene(sceneId: number): void;
  3112. // --调试
  3113. function setEnableDebug(p: {
  3114. enableDebug: boolean,
  3115. success?: () => void,
  3116. fail?: () => void,
  3117. complete?: () => void
  3118. }): void;
  3119. /**
  3120. * 获取日志管理器对象
  3121. * @param param 初始化时的参数
  3122. */
  3123. function getLogManager(param?: {
  3124. /**
  3125. * 取值为0或1,取值为0时会把 App、Page 的生命周期函数和 wx 命名空间下的函数调用写入日志,取值为1则不会。
  3126. * 默认值是 0
  3127. */
  3128. level?: 0 | 1
  3129. }): LogManager;
  3130. // --数据上报
  3131. /**
  3132. * 自定义业务数据监控上报接口。
  3133. * 使用前,需要在「小程序管理后台-运维中心-性能监控-业务数据监控」中新建监控事件,配置监控描述与告警类型。每一个监控事件对应唯一的监控ID,开发者最多可以创建128个监控事件。
  3134. * @param name 监控ID,在「小程序管理后台」新建数据指标后获得
  3135. * @param value 上报数值,经处理后会在「小程序管理后台」上展示每分钟的上报总量
  3136. */
  3137. function reportMonitor(name: string, value: number): void;
  3138. // --订阅消息
  3139. /**
  3140. * 调起小游戏订阅消息界面,返回用户订阅消息的操作结果。(需要在 touchend 事件的回调中调用)
  3141. */
  3142. function requestSubscribeMessage(param: {
  3143. /**
  3144. * 需要订阅的消息模板的id的集合(注意:iOS客户端7.0.6版本、Android客户端7.0.7版本之后的一次订阅才支持多个模板消息,iOS客户端7.0.5版本、Android客户端7.0.6版本之前的一次订阅
  3145. * 只支持一个模板消息)消息模板id在[微信公众平台(mp.weixin.qq.com)-功能-订阅消息]中配置
  3146. */
  3147. tmplIds: ReadonlyArray<string>;
  3148. } & types.CallbacksWithType2<{
  3149. /**
  3150. * 接口调用成功时errMsg值为'requestSubscribeMessage:ok'
  3151. */
  3152. errMsg: string;
  3153. /**
  3154. * [TEMPLATE_ID]是动态的键,即模板id,值包括'accept'、'reject'、'ban'。'accept'表示用户同意订阅该条id对应的模板消息,'reject'表示用户拒绝订阅该条id对应的模板消息,'ban'表示
  3155. * 已被后台封禁。例如 { errMsg: "requestSubscribeMessage:ok", zun-LzcQyW-edafCVvzPkK4de2Rllr1fFpw2A_x0oXE: "accept"} 表示用户同意订阅zun-LzcQyW-edafCVvzPkK4de2Rllr1fFpw2A_x0oXE这条消息
  3156. */
  3157. [TEMPLATE_ID: string]: 'accept' | 'reject' | 'ban' | string;
  3158. }, {
  3159. /**
  3160. * 接口调用失败错误信息
  3161. */
  3162. errMsg: string;
  3163. /**
  3164. * 接口调用失败错误码
  3165. */
  3166. errCode: number;
  3167. }>): void;
  3168. // --数据缓存
  3169. /**
  3170. * 清理本地数据缓存
  3171. */
  3172. function clearStorage(param: types.Callbacks): void;
  3173. /**
  3174. * clearStorage的同步版本
  3175. */
  3176. function clearStorageSync(): void;
  3177. /**
  3178. * 从本地缓存中异步获取指定 key 的内容
  3179. */
  3180. function getStorage(param: types.GetStorageParams): void;
  3181. /**
  3182. * getStorage 的同步版本
  3183. */
  3184. function getStorageSync(key: string): any;
  3185. /**
  3186. * 异步获取当前storage的相关信息
  3187. */
  3188. function getStorageInfo(param: types.CallbacksWithType<types.StorageInfo>): void;
  3189. /**
  3190. * getStorageInfo 的同步版本
  3191. */
  3192. function getStorageInfoSync(): types.StorageInfo;
  3193. /**
  3194. * 从本地缓存中移除指定 key
  3195. */
  3196. function removeStorage(param: types.RemoveStorageParams): void;
  3197. /**
  3198. * removeStorage 的同步版本
  3199. * @param key 本地缓存中指定的 key
  3200. */
  3201. function removeStorageSync(key: string): void;
  3202. /**
  3203. * 将数据存储在本地缓存中指定的 key 中,会覆盖掉原来该 key 对应的内容。
  3204. */
  3205. function setStorage(param: types.SetStorageParams): void;
  3206. /**
  3207. * setStorage 的同步版本
  3208. * @param key 本地缓存中指定的 key
  3209. * @param data 需要存储的内容
  3210. */
  3211. function setStorageSync(key: string, data: any): void;
  3212. // --分包加载
  3213. /**
  3214. * 触发分包加载,详见 分包加载
  3215. */
  3216. function loadSubpackage(param: {
  3217. /**
  3218. * 分包的名字,可以填 name 或者 root
  3219. */
  3220. name: string,
  3221. success?: () => void,
  3222. fail?: () => void,
  3223. complete?: () => void
  3224. }): LoadSubpackageTask;
  3225. // --菜单
  3226. /**
  3227. * 获取菜单按钮的布局置信息
  3228. */
  3229. function getMenuButtonBoundingClientRect(): {
  3230. /**
  3231. * 宽度
  3232. */
  3233. width: number,
  3234. /**
  3235. * 高度
  3236. */
  3237. height: number,
  3238. /**
  3239. * 上边界坐标
  3240. */
  3241. top: number,
  3242. /**
  3243. * 右边界坐标
  3244. */
  3245. right: number,
  3246. /**
  3247. * 下边界坐标
  3248. */
  3249. bottom: number,
  3250. /**
  3251. * 左边界坐标
  3252. */
  3253. left: number
  3254. };
  3255. function setMenuStyle(param: {
  3256. /**
  3257. * 样式风格
  3258. */
  3259. style: "light" | "dark",
  3260. success?: () => void,
  3261. fail?: () => void,
  3262. complete?: () => void
  3263. }): void;
  3264. // --交互
  3265. /**
  3266. * 显示消息提示框
  3267. */
  3268. function showToast(param: {
  3269. /**
  3270. * 提示的内容
  3271. */
  3272. title?: string,
  3273. /**
  3274. * 图标
  3275. */
  3276. icon?: "success" | "loading",
  3277. /**
  3278. * 自定义图标的本地路径,image 的优先级高于 icon
  3279. */
  3280. image?: string,
  3281. /**
  3282. * 提示的延迟时间
  3283. */
  3284. duration?: number,
  3285. success?: () => void,
  3286. fail?: () => void,
  3287. complete?: () => void
  3288. }): void;
  3289. /**
  3290. * 隐藏消息提示框
  3291. */
  3292. function hideToast(cb?: types.Callbacks): void;
  3293. /**
  3294. * 显示模态对话框
  3295. */
  3296. function showModal(param: {
  3297. /**
  3298. * 提示的标题
  3299. */
  3300. title?: string,
  3301. /**
  3302. * 提示的内容
  3303. */
  3304. content?: string,
  3305. /**
  3306. * 是否显示取消按钮,默认true
  3307. */
  3308. showCancel?: boolean,
  3309. /**
  3310. * 取消按钮的文字,最多 4 个字符串
  3311. */
  3312. cancelText?: string,
  3313. /**
  3314. * 取消按钮的文字颜色,必须是 16 进制格式的颜色字符串,默认值#000000
  3315. */
  3316. cancelColor?: string,
  3317. /**
  3318. * 确认按钮的文字,最多 4 个字符串
  3319. */
  3320. confirmText?: string,
  3321. /**
  3322. * 确认按钮的文字颜色,必须是 16 进制格式的颜色字符串,默认值#3cc51f
  3323. */
  3324. confirmColor?: string,
  3325. success?: (res: { confirm?: boolean, cancel?: boolean }) => void,
  3326. fail?: () => void,
  3327. complete?: () => void
  3328. }): void;
  3329. /**
  3330. * 显示 loading 提示框, 需主动调用 wx.hideLoading 才能关闭提示框
  3331. */
  3332. function showLoading(prms?: {
  3333. /**
  3334. * 提示的内容
  3335. */
  3336. title?: string,
  3337. /**
  3338. * 是否显示透明蒙层
  3339. */
  3340. mask?: boolean,
  3341. success?: () => void,
  3342. fail?: () => void,
  3343. complete?: () => void
  3344. }): void;
  3345. /**
  3346. * 隐藏 loading 提示框
  3347. */
  3348. function hideLoading(cb?: types.Callbacks): void;
  3349. /**
  3350. * 显示选择器
  3351. */
  3352. function showActionSheet(params: {
  3353. /**
  3354. * 按钮的文字数组,数组长度最大为 6
  3355. */
  3356. itemList: string[],
  3357. /**
  3358. * 按钮的文字颜色,默认值#000000
  3359. */
  3360. itemColor?: string,
  3361. success?: () => void,
  3362. fail?: () => void,
  3363. complete?: () => void
  3364. }): void;
  3365. // --键盘
  3366. function hideKeyboard(): void;
  3367. /**
  3368. * 监听键盘输入事件
  3369. * @param callback.res.value 键盘输入的当前值
  3370. */
  3371. function onKeyboardInput(callback: (res: { value: string }) => void): void;
  3372. /**
  3373. * 取消监听键盘输入事件
  3374. */
  3375. function offKeyboardInput(callback: (res: { value: string }) => void): void;
  3376. /**
  3377. * 监听用户点击键盘 Confirm 按钮时的事件
  3378. * @param callback.res.value 键盘输入的当前值
  3379. */
  3380. function onKeyboardConfirm(callback: (res: { value: string }) => void): void;
  3381. /**
  3382. * 取消监听用户点击键盘 Confirm 按钮时的事件
  3383. */
  3384. function offKeyboardConfirm(callback: (res: { value: string }) => void): void;
  3385. /**
  3386. * 监听监听键盘收起的事件
  3387. * @param callback.res.value 键盘输入的当前值
  3388. */
  3389. function onKeyboardComplete(callback: (res: { value: string }) => void): void;
  3390. /**
  3391. * 取消监听监听键盘收起的事件
  3392. */
  3393. function offKeyboardComplete(callback: (res: { value: string }) => void): void;
  3394. /**
  3395. * 显示键盘
  3396. */
  3397. function showKeyboard(param: {
  3398. /**
  3399. * 键盘输入框显示的默认值
  3400. */
  3401. defaultValue: string,
  3402. /**
  3403. * 键盘中文本的最大长度
  3404. */
  3405. maxLength?: number,
  3406. /**
  3407. * 是否为多行输入
  3408. */
  3409. multiple?: boolean,
  3410. /**
  3411. * 当点击完成时键盘是否收起
  3412. */
  3413. confirmHold?: boolean,
  3414. /**
  3415. * 键盘右下角 confirm 按钮的类型,只影响按钮的文本内容
  3416. */
  3417. confirmType?: "done" | "next" | "search" | "go" | "send"
  3418. }): void;
  3419. /**
  3420. * 更新键盘,只有当键盘处于拉起状态时才会产生效果
  3421. */
  3422. function updateKeyboard(param: {
  3423. /**
  3424. * 键盘输入框的当前值
  3425. */
  3426. value: string,
  3427. success?: () => void,
  3428. fail?: () => void,
  3429. complete?: () => void
  3430. }): void;
  3431. // --状态栏
  3432. /**
  3433. * 当在配置中设置 showStatusBarStyle 时,屏幕顶部会显示状态栏。此接口可以修改状态栏的样式。
  3434. */
  3435. function setStatusBarStyle(param: {
  3436. style: "white" | "black",
  3437. success?: () => void,
  3438. fail?: () => void,
  3439. complete?: () => void
  3440. }): void;
  3441. // --窗口
  3442. /**
  3443. * 监听窗口尺寸变化事件
  3444. */
  3445. function onWindowResize(cb: (res: { windowWidth: number, windowHeight: number }) => void): void;
  3446. /**
  3447. * 取消监听窗口尺寸变化事件
  3448. */
  3449. function offWindowResize(cb: (res: { windowWidth: number, windowHeight: number }) => void): void;
  3450. // --更新
  3451. function getUpdateManager(): UpdateManager;
  3452. // --Worker
  3453. /**
  3454. * 创建一个 Worker 线程,目前限制最多只能创建一个 Worker,创建下一个 Worker 前请调用 Worker.terminate
  3455. */
  3456. function createWorker(): WxWorker;
  3457. // --音频
  3458. /**
  3459. * 创建一个 InnerAudioContext 实例
  3460. */
  3461. function createInnerAudioContext(): InnerAudioContext;
  3462. /**
  3463. * 获取当前支持的音频输入源
  3464. */
  3465. function getAvailableAudioSources(param: types.CallbacksWithType<{
  3466. /**
  3467. * 音频输入源,每一项对应一种音频输入源
  3468. */
  3469. audioSources: ReadonlyArray<types.AudioSourceType>
  3470. }>): void;
  3471. // --录音
  3472. function getRecorderManager(): RecorderManager;
  3473. // --图片
  3474. /**
  3475. * 从本地相册选择图片或使用相机拍照。
  3476. */
  3477. function chooseImage(param: {
  3478. count: number,
  3479. /**
  3480. * 所选的图片的尺寸
  3481. */
  3482. sizeType: ['original'] | ['compressed'] | ['original', 'compressed'],
  3483. /**
  3484. * 选择图片的来源
  3485. */
  3486. sourceType: ['album'] | ['camera'] | ['album', 'camera'],
  3487. success?: (res: { tempFilePaths: ReadonlyArray<string>, tempFiles: ReadonlyArray<ImageFile> }) => void,
  3488. fail?: () => void,
  3489. complete?: () => void
  3490. }): void;
  3491. /**
  3492. * 预览图片,调用之后会在新打开的页面中全屏预览传入的图片,预览的过程中用户可以进行保存图片、发送给朋友等操作
  3493. */
  3494. function previewImage(param: {
  3495. /**
  3496. * 需要预览的图片链接列表
  3497. */
  3498. urls: string[],
  3499. /**
  3500. * 当前显示图片的链接,默认为urls的第一张
  3501. */
  3502. current?: string,
  3503. success?: () => void,
  3504. fail?: () => void,
  3505. complete?: () => void
  3506. }): void;
  3507. /**
  3508. * 保存图片到系统相册。需要用户授权 scope.writePhotosAlbum
  3509. */
  3510. function saveImageToPhotosAlbum(param: {
  3511. /**
  3512. * 图片文件路径,可以是临时文件路径也可以是永久文件路径,不支持网络图片路径
  3513. */
  3514. filePath: string,
  3515. success?: () => void,
  3516. fail?: () => void,
  3517. complete?: () => void
  3518. }): void;
  3519. // --视频
  3520. function createVideo(param: {
  3521. /**
  3522. * 视频的左上角横坐标
  3523. */
  3524. x?: number,
  3525. /**
  3526. * 视频的左上角纵坐标
  3527. */
  3528. y?: number,
  3529. /**
  3530. * 视频的宽度,默认值300
  3531. */
  3532. width?: number,
  3533. /**
  3534. * 默认值150
  3535. */
  3536. height?: number,
  3537. /**
  3538. * 视频的资源地址
  3539. */
  3540. src: string,
  3541. /**
  3542. * 视频的封面
  3543. */
  3544. poster?: string,
  3545. /**
  3546. * 视频的初始播放位置,单位为 s 秒,默认值0
  3547. */
  3548. initialTime?: number,
  3549. /**
  3550. * 视频的播放速率,有效值有 0.5、0.8、1.0、1.25、1.5默认值1.0
  3551. */
  3552. playbackRate?: number,
  3553. /**
  3554. * 视频是否为直播,默认值0
  3555. */
  3556. live?: number,
  3557. /**
  3558. * 视频的缩放模式
  3559. * fill - 填充,视频拉伸填满整个容器,不保证保持原有长宽比例
  3560. * contain - 包含,保持原有长宽比例。保证视频尺寸一定可以在容器里面放得下。因此,可能会有部分空白
  3561. * cover - 覆盖,保持原有长宽比例。保证视频尺寸一定大于容器尺寸,宽度和高度至少有一个和容器一致。因此,视频有部分会看不见
  3562. */
  3563. objectFit?: "contain" | "cover" | "fill",
  3564. /**
  3565. * 视频是否显示控件,默认true
  3566. */
  3567. controls?: boolean,
  3568. /**
  3569. * 视频是否自动播放,默认false
  3570. */
  3571. autoplay?: boolean,
  3572. /**
  3573. * 视频是否是否循环播放,默认值false
  3574. */
  3575. loop?: boolean,
  3576. /**
  3577. * 视频是否禁音播放,默认值false
  3578. */
  3579. muted?: boolean
  3580. }): Video;
  3581. // --相机
  3582. /**
  3583. * 创建相机
  3584. * @param param 创建相机所需的初始化信息
  3585. */
  3586. function createCamera(param?: types.Callbacks & {
  3587. /**
  3588. * 相机的左上角横坐标,默认值0
  3589. */
  3590. x?: number;
  3591. /**
  3592. * 相机的左上角纵坐标,默认值0
  3593. */
  3594. y?: number;
  3595. /**
  3596. * 相机的宽度,默认值300
  3597. */
  3598. width?: number;
  3599. /**
  3600. * 相机的高度,默认值150
  3601. */
  3602. height?: number;
  3603. /**
  3604. * 摄像头朝向,值为 front, back,默认值back
  3605. */
  3606. devicePosition?: "front" | "back";
  3607. /**
  3608. * 闪光灯,值为 auto, on, off,默认值auto
  3609. */
  3610. flash?: "auto" | "on" | "off";
  3611. /**
  3612. * 帧数据图像尺寸,值为 small, medium, large,默认值small
  3613. */
  3614. size?: "small" | "medium" | "large";
  3615. }): Camera;
  3616. // -- VoIP
  3617. /**
  3618. * 更新实时语音静音设置
  3619. * @param param 静音设置
  3620. */
  3621. function updateVoIPChatMuteConfig(param: types.Callbacks & {
  3622. /**
  3623. * 静音设置
  3624. */
  3625. muteConfig: {
  3626. /**
  3627. * 是否静音麦克风,默认值false
  3628. */
  3629. muteMicrophone?: boolean,
  3630. /**
  3631. * 是否静音耳机,默认值false
  3632. */
  3633. muteEarphone?: boolean
  3634. }
  3635. }): void;
  3636. /**
  3637. * 监听实时语音通话成员通话状态变化事件。有成员开始/停止说话时触发回调
  3638. * @param callback 实时语音通话成员通话状态变化事件的回调函数
  3639. */
  3640. function onVoIPChatSpeakersChanged(callback: (res: {
  3641. /**
  3642. * 还在实时语音通话中的成员 openId 名单
  3643. */
  3644. openIdList: ReadonlyArray<string>,
  3645. /**
  3646. * 错误码
  3647. */
  3648. errCode: number,
  3649. /**
  3650. * 调用结果(错误原因)
  3651. */
  3652. errMsg: string
  3653. }) => void): void;
  3654. /**
  3655. * 取消监听实时语音通话成员通话状态变化事件。
  3656. * @param callback 之前监听的回调函数
  3657. */
  3658. function offVoIPChatSpeakersChanged(callback: unknown): void;
  3659. /**
  3660. * 监听实时语音通话成员在线状态变化事件。有成员加入/退出通话时触发回调
  3661. * @param callback 实时语音通话成员在线状态变化事件的回调函数
  3662. */
  3663. function onVoIPChatMembersChanged(callback: (res: {
  3664. /**
  3665. * 还在实时语音通话中的成员 openId 名单
  3666. */
  3667. openIdList: ReadonlyArray<string>,
  3668. /**
  3669. * 错误码
  3670. */
  3671. errCode: number,
  3672. /**
  3673. * 调用结果(错误原因)
  3674. */
  3675. errMsg: string
  3676. }) => void): void;
  3677. /**
  3678. * 取消监听实时语音通话成员在线状态变化事件。
  3679. * @param callback 之前监听的回调函数
  3680. */
  3681. function offVoIPChatMembersChanged(callback: unknown): void;
  3682. /**
  3683. * 监听被动断开实时语音通话事件。包括小游戏切入后端时断开
  3684. * @param callback 被动断开实时语音通话事件的回调函数
  3685. */
  3686. function onVoIPChatInterrupted(callback: (res: {
  3687. /**
  3688. * 错误码
  3689. */
  3690. errCode: number,
  3691. /**
  3692. * 调用结果(错误原因)
  3693. */
  3694. errMsg: string
  3695. }) => void): void;
  3696. /**
  3697. * 取消监听被动断开实时语音通话事件。
  3698. * @param callback 之前监听的回调函数
  3699. */
  3700. function offVoIPChatInterrupted(callback: unknown): void;
  3701. /**
  3702. * 加入 (创建) 实时语音通话,更多信息可见:实时语音指南(https://developers.weixin.qq.com/minigame/dev/guide/open-ability/voip-chat.html)
  3703. * 错误码
  3704. * -1 当前已在房间内
  3705. * -2 录音设备被占用,可能是当前正在使用微信内语音通话或系统通话
  3706. * -3 加入会话期间退出(可能是用户主动退出,或者退后台、来电等原因),因此加入失败
  3707. * -1000 系统错误
  3708. * @param param 加入语音聊天时的初始化参数
  3709. */
  3710. function joinVoIPChat(param: types.CallbacksWithType<{
  3711. /**
  3712. * 在此通话中的成员 openId 名单
  3713. */
  3714. openIdList: ReadonlyArray<string>,
  3715. /**
  3716. * 错误码
  3717. */
  3718. errCode: number,
  3719. /**
  3720. * 调用结果
  3721. */
  3722. errMsg: string
  3723. }> & {
  3724. /**
  3725. * 签名,用于验证小游戏的身份
  3726. */
  3727. signature: string,
  3728. /**
  3729. * 验证所需的随机字符串
  3730. */
  3731. nonceStr: string,
  3732. /**
  3733. * 验证所需的时间戳
  3734. */
  3735. timeStamp: number,
  3736. /**
  3737. * 小游戏内此房间/群聊的 ID。同一时刻传入相同 groupId 的用户会进入到同个实时语音房间。
  3738. */
  3739. groupId: string,
  3740. /**
  3741. * 静音设置
  3742. */
  3743. muteConfig?: {
  3744. /**
  3745. * 是否静音麦克风,默认值false
  3746. */
  3747. muteMicrophone?: boolean,
  3748. /**
  3749. * 是否静音耳机,默认值false
  3750. */
  3751. muteEarphone?: boolean
  3752. }
  3753. }): void;
  3754. /**
  3755. * 退出(销毁)实时语音通话
  3756. */
  3757. function exitVoIPChat(callbacks?: types.Callbacks): void;
  3758. // --广告
  3759. /**
  3760. * 创建 banner 广告组件。请通过 wx.getSystemInfoSync() 返回对象的 SDKVersion 判断基础库版本号 >= 2.0.4 后再使用该 API。同时,开发者工具上暂不支持调试该 API,请直接在真机上进行调试。
  3761. */
  3762. function createBannerAd(param: {
  3763. /**
  3764. * 广告单元 id
  3765. */
  3766. adUnitId: string,
  3767. /**
  3768. * banner 广告组件的样式
  3769. */
  3770. style: types.AdStyle
  3771. }): BannerAd;
  3772. /**
  3773. * 创建激励视频广告组件。请通过 wx.getSystemInfoSync() 返回对象的 SDKVersion 判断基础库版本号 >= 2.0.4 后再使用该 API。同时,开发者工具上暂不支持调试该 API,请直接在真机上进行调试。
  3774. */
  3775. function createRewardedVideoAd(param: {
  3776. /**
  3777. * 广告单元 id
  3778. */
  3779. adUnitId: string
  3780. }): RewardedVideoAd;
  3781. /**
  3782. * 创建插屏广告组件。请通过 wx.getSystemInfoSync() 返回对象的 SDKVersion 判断基础库版本号后再使用该 API。每次调用该方法创建插屏广告都会返回一个全新的实例(小程序端的插屏广告实例不允许跨页面使用)。
  3783. */
  3784. function createInterstitialAd(param: {
  3785. /**
  3786. * 广告单元 id
  3787. */
  3788. adUnitId: string
  3789. }): InterstitialAd;
  3790. // --虚拟支付
  3791. /**
  3792. * 发起米大师支付
  3793. */
  3794. function requestMidasPayment(param: {
  3795. /**
  3796. * 支付的类型,不同的支付类型有各自额外要传的附加参数。
  3797. * game - 购买游戏币
  3798. */
  3799. mode: "game",
  3800. /**
  3801. * 环境配置,默认值0
  3802. * 0 - 米大师正式环境
  3803. * 1 - 米大师沙箱环境
  3804. */
  3805. env?: 0 | 1,
  3806. /**
  3807. * 在米大师侧申请的应用 id
  3808. */
  3809. offerId: string,
  3810. /**
  3811. * 币种
  3812. */
  3813. currencyType: "CNY",
  3814. /**
  3815. * 申请接入时的平台,platform 与应用id有关。
  3816. */
  3817. platform?: "android",
  3818. /**
  3819. * 购买数量。mode=game 时必填。购买数量。详见 buyQuantity 限制说明。
  3820. * mode为game(购买游戏币)时,buyQuantity不可任意填写。需满足 buyQuantity * 游戏币单价 = 限定的价格等级。如:游戏币单价为 0.1 元,一次购买最少数量是 10。
  3821. * 有效价格等级如下:
  3822. * 价格等级(单位:人民币)
  3823. * 1
  3824. * 3
  3825. * 6
  3826. * 8
  3827. * 12
  3828. * 18
  3829. * 25
  3830. * 30
  3831. * 40
  3832. * 45
  3833. * 50
  3834. * 60
  3835. * 68
  3836. * 73
  3837. * 78
  3838. * 88
  3839. * 98
  3840. * 108
  3841. * 118
  3842. * 128
  3843. * 148
  3844. * 168
  3845. * 188
  3846. * 198
  3847. * 328
  3848. * 648
  3849. */
  3850. buyQuantity?: number,
  3851. /**
  3852. * 分区 ID
  3853. */
  3854. zoneId?: string,
  3855. success?: () => void,
  3856. /**
  3857. * @param res.errCode 有如下值:
  3858. * -1 系统失败
  3859. * -2 支付取消
  3860. * -15001 虚拟支付接口错误码,缺少参数
  3861. * -15002 虚拟支付接口错误码,参数不合法
  3862. * -15003 虚拟支付接口错误码,订单重复
  3863. * -15004 虚拟支付接口错误码,后台错误
  3864. * -15006 虚拟支付接口错误码,appId 权限被封禁
  3865. * -15006 虚拟支付接口错误码,货币类型不支持
  3866. * -15007 虚拟支付接口错误码,订单已支付
  3867. * 1 虚拟支付接口错误码,用户取消支付
  3868. * 2 虚拟支付接口错误码,客户端错误, 判断到小程序在用户处于支付中时,又发起了一笔支付请求
  3869. * 3 虚拟支付接口错误码,Android 独有错误:用户使用 Google Play 支付,而手机未安装 Google Play
  3870. * 4 虚拟支付接口错误码,用户操作系统支付状态异常
  3871. * 5 虚拟支付接口错误码,操作系统错误
  3872. * 6 虚拟支付接口错误码,其他错误
  3873. * 1000 参数错误
  3874. * 1003 米大师 Portal 错误
  3875. */
  3876. fail?: (res: { errMsg: string, errCode: number }) => void,
  3877. complete?: () => void
  3878. }): void;
  3879. }