ScreenShot

10min

스크린샷 기능 사용하기
ZepetoWorldContent API의 이미지 관련 기능을 사용하여 월드 내에서 이미지를 저장하거나 공유하고, 피드에 이미지를 게시할 수 있습니다.
ZepetoWorldContent API는 다음과 같은 이미지 관련 기능을 제공합니다.
API
설명
ZepetoWorldContent.SaveToCameraRoll(rt: UnityEngine.RenderTexture, result: System.Action$1)
이미지를 사진 라이브러리에 저장합니다.
ZepetoWorldContent.SaveToCameraRoll(texture: UnityEngine.Texture2D, result: System.Action$1)
이미지를 사진 라이브러리에 저장합니다.
ZepetoWorldContent.Share(rt: UnityEngine.RenderTexture, result: System.Action$1)
이미지를 외부 앱에 공유합니다.
ZepetoWorldContent.Share(texture: UnityEngine.Texture2D, result: System.Action$1)
이미지를 외부 앱에 공유합니다.
ZepetoWorldContent.CreateFeed(rt: UnityEngine.RenderTexture, contents: string, result: System.Action$1)
이미지를 피드에 업로드합니다. 게시물의 내용은 두 번째 인수인 contents를 통해 지정할 수 있습니다. 월드 태그는 자동으로 적용되어 피드에 게시됩니다.
ZepetoWorldContent.CreateFeed(texture: UnityEngine.Texture2D, contents: string, $result: System.Action$1)
이미지를 피드에 업로드합니다. 게시물의 내용은 두 번째 인수인 contents를 통해 지정할 수 있습니다. 월드 태그는 자동으로 적용되어 피드에 게시됩니다.
﻿
다음은 ZepetoWorldContent 내에서 이미지 기능을 호출하는 예입니다.
TypeScript
ZepetoWorldContent.SaveToCameraRoll(this.renderTexture, (result: boolean) => {console.log(`저장 결과 : ${result}`)});
ZepetoWorldContent.SaveToCameraRoll(this.texture2D, (result: boolean) => {console.log(`저장 결과 : ${result}`)});

ZepetoWorldContent.Share(this.renderTexture, (result: boolean) => {console.log(`공유 결과 : ${result}`)});
ZepetoWorldContent.Share(this.texture2D, (result: boolean) => {console.log(`공유 결과 : ${result}`)});

ZepetoWorldContent.CreateFeed(this.renderTexture, "[content]", (result: boolean) => {console.log(`피드 생성 결과 : ${result}`)});
ZepetoWorldContent.CreateFeed(this.texture2D, "[content]", (result: boolean) => {console.log(`피드 생성 결과 : ${result}`)});
ZepetoWorldContent.SaveToCameraRoll(this.renderTexture, (result: boolean) => {console.log(`저장 결과 : ${result}`)});
ZepetoWorldContent.SaveToCameraRoll(this.texture2D, (result: boolean) => {console.log(`저장 결과 : ${result}`)});

ZepetoWorldContent.Share(this.renderTexture, (result: boolean) => {console.log(`공유 결과 : ${result}`)});
ZepetoWorldContent.Share(this.texture2D, (result: boolean) => {console.log(`공유 결과 : ${result}`)});

ZepetoWorldContent.CreateFeed(this.renderTexture, "[content]", (result: boolean) => {console.log(`피드 생성 결과 : ${result}`)});
ZepetoWorldContent.CreateFeed(this.texture2D, "[content]", (result: boolean) => {console.log(`피드 생성 결과 : ${result}`)});
﻿
﻿
다음은 RenderTexture를 사용하여 ZepetoWorldContent의 스크린샷 모드 기능을 사용하는 예제 코드입니다.
TypeScript
import { Camera, RenderTexture } from 'UnityEngine';
import { Button, Text } from 'UnityEngine.UI';
import { SpawnInfo, ZepetoPlayers } from 'ZEPETO.Character.Controller';
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { WorldService, ZepetoWorldContent } from 'ZEPETO.World';

export default class ZepetoWorldContentExample extends ZepetoScriptBehaviour {

    // ZepetoWorldContent 스크린샷 UI
    public cameraRenderButton: Button;
    public saveToCameraRollButton: Button;
    public shareButton: Button;
    public createFeedButton: Button;
    public logText: Text;

    // 렌더 카메라
    private camera: Camera;

    // 렌더 텍스처
    public renderTexture: RenderTexture;

    Start() {
        ZepetoPlayers.instance.CreatePlayerWithUserId(WorldService.userId, new SpawnInfo(), true);
        ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {
            this.camera = ZepetoPlayers.instance.LocalPlayer.zepetoCamera.camera;
        });

        this.cameraRenderButton.onClick.AddListener(() => {
            this.camera.targetTexture = this.renderTexture;
            this.camera.Render();
            this.camera.targetTexture = null;
        });

        this.saveToCameraRollButton.onClick.AddListener(() => {
            ZepetoWorldContent.SaveToCameraRoll(this.renderTexture, (result: boolean) => {
                this.logText.text = `저장 결과 : ${result}`;
            });
        });

        this.shareButton.onClick.AddListener(() => {
            ZepetoWorldContent.Share(this.renderTexture, (result: boolean) => {
                this.logText.text = `공유 결과 : ${result}`;
            });
        });

        this.createFeedButton.onClick.AddListener(() => {
            ZepetoWorldContent.CreateFeed(this.renderTexture, "[CONTENT]", (result: boolean) => {
                this.logText.text = `피드 생성 결과 : ${result}`;
            });
        });
    }
}
import { Camera, RenderTexture } from 'UnityEngine';
import { Button, Text } from 'UnityEngine.UI';
import { SpawnInfo, ZepetoPlayers } from 'ZEPETO.Character.Controller';
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { WorldService, ZepetoWorldContent } from 'ZEPETO.World';

export default class ZepetoWorldContentExample extends ZepetoScriptBehaviour {

    // ZepetoWorldContent 스크린샷 UI
    public cameraRenderButton: Button;
    public saveToCameraRollButton: Button;
    public shareButton: Button;
    public createFeedButton: Button;
    public logText: Text;

    // 렌더 카메라
    private camera: Camera;

    // 렌더 텍스처
    public renderTexture: RenderTexture;

    Start() {
        ZepetoPlayers.instance.CreatePlayerWithUserId(WorldService.userId, new SpawnInfo(), true);
        ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {
            this.camera = ZepetoPlayers.instance.LocalPlayer.zepetoCamera.camera;
        });

        this.cameraRenderButton.onClick.AddListener(() => {
            this.camera.targetTexture = this.renderTexture;
            this.camera.Render();
            this.camera.targetTexture = null;
        });

        this.saveToCameraRollButton.onClick.AddListener(() => {
            ZepetoWorldContent.SaveToCameraRoll(this.renderTexture, (result: boolean) => {
                this.logText.text = `저장 결과 : ${result}`;
            });
        });

        this.shareButton.onClick.AddListener(() => {
            ZepetoWorldContent.Share(this.renderTexture, (result: boolean) => {
                this.logText.text = `공유 결과 : ${result}`;
            });
        });

        this.createFeedButton.onClick.AddListener(() => {
            ZepetoWorldContent.CreateFeed(this.renderTexture, "[CONTENT]", (result: boolean) => {
                this.logText.text = `피드 생성 결과 : ${result}`;
            });
        });
    }
}
﻿
유니티 에디터 모드에서는 확인할 수 없지만, 앱에서 플레이할 때 확인할 수 있습니다.
﻿
스크린샷 샘플
예제 프로젝트는 Github에서 다운로드할 수 있습니다.
📘 공식 스크린샷 샘플
Github : https://github.com/naverz/zepeto-multiplay-example﻿
👍 스크린샷 샘플 설명
이것은 ZepetoWorldContent API의 이미지 관련 기능을 사용하는 스크린샷 예제 프로젝트입니다.
프로젝트를 실행하기 전에 ZEPETO 로그인이 필요합니다.
셀카 모드와 ZepetoCamera 모드로 구성되어 있으며, RenderTexture를 통해 이미지를 저장하거나 공유하고, 이미지를 사용하여 피드를 생성합니다.
﻿
기존 프로젝트에 적용하기 위한 가이드라인
기존 프로젝트에 적용할 때는 아래의 가이드라인을 따르는 것이 좋습니다.
Zepeto.World 버전은 1.21.14 이상이어야 합니다.
1.21.14 이상 버전의 월드에서 진행할 경우 ZepetoWorldContent 기능을 정상적으로 사용할 수 있습니다. 버전 업데이트는 Window - PackageManager - Zepeto.World에서 가능합니다.
샘플 프로젝트의 레이어 21은 플레이어로 지정되어 있습니다.
기존 프로젝트에 적용할 때 사용자 정의 레이어 21을 사용하는 경우, ZepetoScreenShotModule.ts의 playerLayer 값을 수정해 주세요.
﻿
﻿
ZepetoPlayers는 씬에 있어야 합니다.
플레이어 생성 코드는 별도로 작성해야 합니다.
프로젝트의 PlayerCreator.ts 파일을 참조해 주세요.
ZepetoScreenShotModule을 씬에 삽입해야 합니다.
﻿
IKPass가 활성화된 애니메이터를 사용해야 합니다.
﻿
﻿
👍 IKPass
기존 ZepetoAnimator를 사용할 때
ZepetoPlayers에서 ZepetoAnimator 파일을 로컬 환경의 Assets/... 경로로 드래그하고 해당 자산을 복사합니다.
복사한 ZepetoAnimator의 IKPass를 활성화하고,
ZepetoPlayers의 Animator Controller를 해당 애니메이터로 교체합니다.
커스텀 애니메이터를 사용할 때
현재 사용 중인 애니메이터의 IKPass를 활성화합니다.
﻿
회전 방향은 수평을 기준으로 지원됩니다.
ZepetoWorldSetting에서 방향을 수평으로 설정합니다.
﻿
﻿
카메라 설정에 관하여
ZepetoCamera 모드의 카메라 설정은 ZepetoPlayers - Camera의 설정을 수정합니다.
﻿
﻿
셀카 카메라 모드의 카메라 설정은 Resources - Selfie Camera prefab의 Selfie Camera.ts의 설정 값을 변경합니다.
﻿
﻿

API	설명
ZepetoWorldContent.SaveToCameraRoll(rt: UnityEngine.RenderTexture, result: System.Action$1)	이미지를 사진 라이브러리에 저장합니다.
ZepetoWorldContent.SaveToCameraRoll(texture: UnityEngine.Texture2D, result: System.Action$1)	이미지를 사진 라이브러리에 저장합니다.
ZepetoWorldContent.Share(rt: UnityEngine.RenderTexture, result: System.Action$1)	이미지를 외부 앱에 공유합니다.
ZepetoWorldContent.Share(texture: UnityEngine.Texture2D, result: System.Action$1)	이미지를 외부 앱에 공유합니다.
ZepetoWorldContent.CreateFeed(rt: UnityEngine.RenderTexture, contents: string, result: System.Action$1)	이미지를 피드에 업로드합니다. 게시물의 내용은 두 번째 인수인 contents를 통해 지정할 수 있습니다. 월드 태그는 자동으로 적용되어 피드에 게시됩니다.
ZepetoWorldContent.CreateFeed(texture: UnityEngine.Texture2D, contents: string, $result: System.Action$1)	이미지를 피드에 업로드합니다. 게시물의 내용은 두 번째 인수인 contents를 통해 지정할 수 있습니다. 월드 태그는 자동으로 적용되어 피드에 게시됩니다.

업데이트됨 11 Oct 2024

이 페이지가 도움이 되었습니까?

음성 채팅 기능 사용하기

VideoRecording