본문으로 건너뛰기

clipboard

시스템 클립보드를 읽고 쓰는 네임스페이스입니다. 초대 코드 공유, 쿠폰 붙여넣기, "링크 복사" 버튼 같은 흔한 모바일 UX에 쓰입니다.

메서드​

메서드용도
getClipboardText클립보드에서 텍스트를 읽어 옵니다.
setClipboardText클립보드에 텍스트를 복사합니다.

권한​

네임스페이스 전체가 단일 clipboard 권한을 공유합니다. 두 메서드 모두 같은 PermissionName에 바인딩되어 있습니다. 한쪽에서 승인받으면 다른 쪽도 즉시 사용 가능하고, setClipboardText.getPermission()과 getClipboardText.getPermission()은 언제나 같은 값을 돌려줍니다 — 상태 확인은 둘 중 편한 쪽으로 하면 됩니다.

  • denied 상태에서 호출하면 에러가 throw 됩니다. 호출 전 getPermission()으로 상태를 확인하세요.
  • 권한이 아직 없으면 openPermissionDialog()로 시스템 다이얼로그를 띄울 수 있습니다.

두 메서드 모두 getPermission() / openPermissionDialog() 유틸이 함수 객체에 붙어 있습니다 — 각 페이지의 "권한" 섹션을 참고하세요.

UX 가이드​

  • **쓰기(write)**는 사용자가 "복사" 같은 명시적 액션을 눌렀을 때 수행하고, 성공 시 토스트로 피드백을 주세요.
  • **읽기(read)**는 자동 읽기 대신 "붙여넣기" 버튼에서만 호출하길 권장합니다. 백그라운드에서의 클립보드 접근은 사용자 입장에서 예상 밖의 동작이고, OS가 차후 차단할 가능성도 있습니다.
  • 읽어 온 문자열은 항상 검증하세요. 사용자가 의도하지 않은 텍스트가 들어 있을 수 있습니다 (초대 코드 형식 검사, URL 도메인 화이트리스트 등).

직접 실행해 보기​

sdk-example의 Clipboard 페이지에서 두 메서드를 모두 실험해 볼 수 있습니다.

sdk-example에서 실행해 보기

외부 참조​