registerScreenguardPartially MỚI ✨

Kích hoạt ScreenGuard cho một vùng view cụ thể trên màn hình trong ảnh chụp và bản ghi màn hình, thay vì toàn bộ màn hình. (Chỉ hỗ trợ iOS)

Khả dụng từ v2.0.2+

Yêu cầu v2.0.0+

Bạn phải gọi initSettings() trước khi sử dụng hàm này.

Tham số

Nhận một đối tượng JS với các tham số sau:

Tên	Bắt buộc	Kiểu	Giá trị mặc định	Mô tả
viewRef	Có	React.RefObject<any>		Một React ref trỏ đến component đã được mount. Vị trí và kích thước trên màn hình được đo qua measureInWindow().
backgroundColor	Không	string	'#000000'(đen)	Chuỗi màu hex dùng để tô/che vùng trong ảnh chụp màn hình.

warning

Hàm này chỉ hỗ trợ các màn hình tĩnh, ít thay đổi về nội dung hoặc kích thước. Không hỗ trợ các component thường xuyên thay đổi vị trí hoặc các màn hình có ScrollView.

Code mẫu

import React, { useRef } from 'react';
import { View, Text, Button } from 'react-native';
import ScreenGuardModule from 'react-native-screenguard';

const App = () => {
  const sensitiveRef = useRef<View>(null);

  const enablePartialGuard = async () => {
    // Khởi tạo trước (bắt buộc trong v2.0.0+)
    await ScreenGuardModule.initSettings();

    // Chỉ che vùng view nhạy cảm
    await ScreenGuardModule.registerScreenguardPartially({
      viewRef: sensitiveRef,
      backgroundColor: '#000000',
    });
  };

  return (
    <View>
      <View ref={sensitiveRef}>
        <Text>Nội dung này sẽ bị che trong ảnh chụp màn hình</Text>
      </View>
      <Button title="Bật Guard" onPress={enablePartialGuard} />
    </View>
  );
};

Demo

iOS