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()) {
   & D* |# r/ |  C+ ~1 |
4.   qrScanner.isOpened(); // false
   , O0 {' [* D) }
5.   const promise = qrScanner.open({
   1 M$ e: O" e- c: y9 ^7 [1 k2 \
6.     text: 'Scan the QR',
   
7.     onCaptured(qr) {
   4 O: d- ]+ d: |0 A# [. _  W
8.       if (qr === 'qr-content-we-expect') {
   
9.         qrScanner.close();
   + n. Q: p6 i; A$ d  I2 P8 F
10.       }
    / @( c( o! e9 q
11.     },
    
12.   });
    3 y* Z1 U& Y) K  n- ]7 Y* c
13.   qrScanner.isOpened(); // true
    9 d; @6 {+ g: _4 G! x* J
14.   await promise;
    ; `/ z5 f6 h7 S, Y3 g* Q) Y
15.   qrScanner.isOpened(); // false
    
16. }

复制代码

Functions :

1. import {
   
2.   openQrScanner,
   5 E. o3 f6 Z$ X8 x2 _' P* r: A
3.   closeQrScanner,
   
4.   isQrScannerOpened,
     O: P5 H8 Z9 |0 s
5. } from '@telegram-apps/sdk';
   
6. 
   + @) m1 I" W, k, e  H- Z
7. if (openQrScanner.isSupported()) {
   
8.   isQrScannerOpened(); // false
   $ Z6 v$ i+ S! M$ c( }! q( @$ y. Y$ Y
9.   const promise = openQrScanner({
   6 x: c2 Y/ Q0 R; t% E
10.     text: 'Scan the QR',
    9 @) d. B$ D8 y8 K" e: p, y4 N
11.     onCaptured(qr) {
    
12.       if (qr === 'qr-content-we-expect') {
    
13.         closeQrScanner();
    
14.       }
    : d$ D7 L% u  H
15.     },
    8 x1 L3 n' V6 R
16.   });
    
17.   isQrScannerOpened(); // true
    
18.   await promise;
    
19.   isQrScannerOpened(); // true
    1 [, j+ u, T1 V7 h. Y& L
20. }

复制代码

异步风格​

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

Variable :

1. import { qrScanner } from '@telegram-apps/sdk';
   ' ?3 J. S. g% j! F8 h0 o" w" ]# f. r
2. 
   7 @0 t8 P* O# o! o! B/ m
3. if (qrScanner.open.isSupported()) {
   
4.   // Getting the first captured QR.
   4 s8 d2 Y& i$ _/ A* H3 _- H
5.   qrScanner.isOpened(); // false
   
6.   let promise = qrScanner.open({ text: 'Scan any QR' });
     N: }& B2 e9 K' v! O
7.   qrScanner.isOpened(); // true
   # n- G* V! p$ k' a8 R  H
8.   await promise;
   ; M% ]4 e8 j& P( Y
9.   qrScanner.isOpened(); // false
   
10. 
    
11.   // Getting some specific QR.
    
12.   qrScanner.isOpened(); // false
    
13.   promise = qrScanner.open({
    9 l/ G$ i! p, U# p3 J) g. w9 L
14.     text: 'Scan some specific QR',
    
15.     capture(qr) {
    
16.       return qr === 'some-specific-qr';
    - \0 w3 {$ F; [/ j' _! C
17.     },
    - i, W" f( X/ @
18.   });
    9 t1 b0 F! p) E, ]& t; u9 c
19.   qrScanner.isOpened(); // true
    ' G1 \! k' _/ Y- Z2 J7 j
20.   await promise;
    
21.   qrScanner.isOpened(); // false
    " s) O  \! i5 ^" p! v
22. }

复制代码

Functions :

1. import {
   
2.   openQrScanner,
   
3.   closeQrScanner,
   
4.   isQrScannerOpened,
   : e" Z2 l& \. u1 X
5. } from '@telegram-apps/sdk';
   ) d* e  {2 D# V. T! I
6. 
   - _! f. F# P. w1 F7 q! Y  F3 W
7. if (openQrScanner.isSupported()) {
   " @6 l! |: M+ @) t' t( Z0 p
8.   // Getting the first captured QR.
   3 s/ w+ b: d7 |; P$ y; ]: ?
9.   // isQrScannerOpened() -> false
   + }9 D# o$ X' x" w3 q4 G: q
10.   let promise = openQrScanner({ text: 'Scan any QR' });
    
11.   // isQrScannerOpened() -> true
    . O' w3 n- F* M4 e; J
12.   await promise;
    
13.   // isQrScannerOpened() -> false
    
14. 
    4 _7 }- E) m* t" Y( R, f% h* M
15.   // Getting some specific QR.
    + I* Y1 }* D& d$ l' s0 d
16.   // isQrScannerOpened() -> false
    
17.   promise = openQrScanner({
    
18.     text: 'Scan some specific QR',
    6 j7 m2 ^4 X( n) x
19.     capture(qr) {
      B3 r' ?  D* v3 U/ `3 \) G2 m
20.       return qr === 'some-specific-qr';
      v( s' c  J7 w. c' _
21.     },
    
22.   });
    : b$ e( m4 S- d( Y; X- R9 _
23.   // isQrScannerOpened() -> true
    
24.   await promise;
    - o6 z: o' g4 T; \5 W! W7 x! [& W3 y
25.   // isQrScannerOpened() -> false
    
26. }

复制代码

3 A9 w. E4 Y6 s0 g5 ?
9 V5 u6 K1 J& C3 ~# R5 Q