Telegram 小程序 | TypeScript @telegram-apps/sdk @2.x | 组件 | QR 扫描仪

riyad

QR 扫描仪​

提供 QR 扫描仪功能的💠组件。

打开和关闭​

要打开 QR 扫描仪，开发人员应使用 open 方法。 它接受可选的 text 属性，负责显示扫描仪标题属性，具体取决于打开的样式。

反过来，调用 open 方法会更新 isOpened 信号属性值。

要关闭扫描仪，请使用 close 方法。

回调样式​

接受 onCaptured 选项，这是一个接收扫描的 QR 内容的函数。 该方法 返回一个承诺，该承诺将在扫描仪关闭后解析。

Variable :

1. import { qrScanner } from '@telegram-apps/sdk';
   
2. 
   
3. if (qrScanner.open.isSupported()) {
   
4.   qrScanner.isOpened(); // false
   6 x4 b4 W8 g0 }% ~9 W6 m
5.   const promise = qrScanner.open({
   
6.     text: 'Scan the QR',
   9 X# S' d1 V! w7 a! B& V2 k0 v
7.     onCaptured(qr) {
   
8.       if (qr === 'qr-content-we-expect') {
   % ~2 }  Z) c7 g: j( ]+ a4 Z, @
9.         qrScanner.close();
   & |  u" E- b1 I3 H% ?2 e
10.       }
    
11.     },
    + z9 X# O9 j  y$ l3 d
12.   });
    
13.   qrScanner.isOpened(); // true
    
14.   await promise;
    
15.   qrScanner.isOpened(); // false
    
16. }

复制代码

Functions :

1. import {
   
2.   openQrScanner,
   
3.   closeQrScanner,
   
4.   isQrScannerOpened,
   
5. } from '@telegram-apps/sdk';
   . ?6 A  Q' ]' `5 }3 g
6. 
   . M5 v5 f$ H9 y, l1 H4 [
7. if (openQrScanner.isSupported()) {
   
8.   isQrScannerOpened(); // false
   
9.   const promise = openQrScanner({
   % k6 @3 _' _: _6 w
10.     text: 'Scan the QR',
    
11.     onCaptured(qr) {
    0 f/ z7 x7 H, Q$ x: q9 h
12.       if (qr === 'qr-content-we-expect') {
    
13.         closeQrScanner();
      R# b" \: R' D# X! [, L
14.       }
    ' C) Y' t+ t# b+ o6 y
15.     },
    * N, Y4 u$ X$ G2 r5 l! d  A- |
16.   });
    $ k( J- X: n0 k+ r  T' o2 Q. x
17.   isQrScannerOpened(); // true
    ) |/ Y5 S" G, q2 I5 M# S) i+ o; L
18.   await promise;
    
19.   isQrScannerOpened(); // true
    
20. }

复制代码

异步风格​

接受可选的 capture 选项，接收扫描的 QR 内容，如果应该捕获并承诺解决，则返回 true。 如果省略，将解析第一个捕获的 QR 内容。 如果由于某种原因扫描仪被关闭，则承诺可能被解析为 undefined。

Variable :

1. import { qrScanner } from '@telegram-apps/sdk';
   + D' I( Z  H$ U4 b- Y7 `
2. 
   1 K% D9 x/ A2 J' E) W
3. if (qrScanner.open.isSupported()) {
   
4.   // Getting the first captured QR.
   
5.   qrScanner.isOpened(); // false
   
6.   let promise = qrScanner.open({ text: 'Scan any QR' });
   
7.   qrScanner.isOpened(); // true
   4 A" x. N9 s2 Y8 `
8.   await promise;
   
9.   qrScanner.isOpened(); // false
   
10. 
    2 V) ^. @+ H6 s0 D! K7 |( I( d: c" s
11.   // Getting some specific QR.
    
12.   qrScanner.isOpened(); // false
    
13.   promise = qrScanner.open({
    
14.     text: 'Scan some specific QR',
    . H/ M* t) Y4 b5 _/ q: k
15.     capture(qr) {
    
16.       return qr === 'some-specific-qr';
    5 [  S! G: c, }1 ~0 R' J. {. L/ `( g
17.     },
    
18.   });
    / @4 o# h# m$ a! t- t" v6 Y
19.   qrScanner.isOpened(); // true
    
20.   await promise;
    
21.   qrScanner.isOpened(); // false
    
22. }

复制代码

Functions :

1. import {
   ' i1 r  z- a. H  \5 p! z) O
2.   openQrScanner,
   8 l9 {3 y4 @4 L
3.   closeQrScanner,
   
4.   isQrScannerOpened,
   
5. } from '@telegram-apps/sdk';
   5 f( _$ |; q5 o+ I
6. 
   / b3 z! R3 [9 Z5 H
7. if (openQrScanner.isSupported()) {
   
8.   // Getting the first captured QR.
   * u3 s! O9 [& I- E0 B7 c* V
9.   // isQrScannerOpened() -> false
   
10.   let promise = openQrScanner({ text: 'Scan any QR' });
    : H( j* J/ E) O% W, y$ l* p: X
11.   // isQrScannerOpened() -> true
    1 A+ U' ~' W' O) X- H1 ~
12.   await promise;
    
13.   // isQrScannerOpened() -> false
    1 x6 N- L' T6 v5 ^* h
14. 
    * M. r! y1 q$ A9 R  U
15.   // Getting some specific QR.
    - j* n; g" \% h! p
16.   // isQrScannerOpened() -> false
    
17.   promise = openQrScanner({
    
18.     text: 'Scan some specific QR',
    
19.     capture(qr) {
    
20.       return qr === 'some-specific-qr';
    
21.     },
    & ?& T% u% V, e2 G3 O* j2 e
22.   });
    
23.   // isQrScannerOpened() -> true
    - ]2 b( w0 k4 I! l
24.   await promise;
    ( b' x8 v  {/ l; G% {" w
25.   // isQrScannerOpened() -> false
    
26. }

复制代码